The Payment API supports a statement_descriptor parameter that can be used to ensure that the paying customer finds a recognizable indicator for their order in the transaction details at their bank.
The field can be sent in at payment creation, at capture -if the payment method allows a separate capture-, or for a refund that you're initiating. In case you provide the statement_descriptor on both payment creation and capture, the latter will override the former at capture.
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.