Skip to content

Dynamic billing descriptor

Last updated: 29th June 2022

The billing descriptor is the text that is displayed on the customer's credit card statement identifying a purchase from a merchant’s website. This descriptor can be set dynamically in a payment request.

If you would like to enable this functionality, please contact your Customer Success manager.


Parameters

Field nameDescription

billing_descriptor

optional
object

Details about the billing descriptor.

billing_descriptor.name

required
string

Dynamic description of the charge. Up to 25 characters

billing_descriptor.city

required
string

City from which the charge originated. Up to 13 characters

You can use the following characters in your descriptor:

  • Uppercase: A-Z
  • Lowercase: a-z
  • Numbers: 0-9
  • Special characters: . ! * - = _

Example

1
2
3
4
"billing_descriptor": {
"name": "Checkout.com",
"city": "London"
}

On this page