Dynamic Descriptors

Dynamic Descriptors

A descriptor is what your customers will see on their bank statement when they make a purchase through your mobile app or website.

So, to make sure that every transaction happening on your website can be clearly traced, configure a descriptor that you and your customers can easily identify.

Dynamic descriptors are typically composed of a name and phone number or URL. The name generally includes both the business name and product name, separated by an asterisk (*).

1. Name – Name displayed for the dynamic descriptor. Braintree requires this to be in a very specific format.There are three formats you may use, and letters must be separated by an asterisk:
   • 
     
     
     
     • (3 letters)*(up to 18 letters) – 3 letters to represent company name, up to 18 letters to represent product name. Example:
       YIT*DESCRIPTION
     
     
     • (7 letters)*(up to 14 letters) – 7 letters to represent company name, up to 14 letters to represent product name. Example:
       YITHEME*DESCRIPTION
     
     
     • (12 letters)*(up to 9 letters) – 12 letters to represent company name, up to 9 letters to represent product name. Example:
       YITHEMESSHOP*DESCR
     
     
     
     

      

     
     
2. Phone (only for Card payments) – Your phone number. It must be max 14 characters, and can only contain numbers, dashes, parentheses, or periods.
3. URL (only for Card payments) – Your website URL. It must be 13 characters or less.The dynamic description will be shown in the transaction details. See an example here:

To read more about Descriptors, please, refer to the official Braintree documentation.