The statement descriptor
The Payment API supports a statement_descriptor
parameter that can be used to ensure that the paying customer finds a recognizable indicator for their payment in the transaction details at their bank.
The field can be sent in at payment creation, at capture and on refund requests if the payment method supports it.
Requirements
- Values must be 4-50 characters in length. Maximum length varies by payment method;
- Only latin characters are allowed;
- The characters that are accepted are: a-z, A-Z, 0-9 and . , ' _ - ? + * /
- The statement descriptor cannot be composed of only spaces.
It is important to ensure that you're sending the descriptor in line with the requirements. Not meeting any or more of the requirements will result in a validation error, in which case you will miss out on conversion. Therefore, we recommend against allowing your clients and their customers to control this value, or if you do, validate the input with above requirements.