Skip to content

Dynamic billing descriptor

Last updated: April 29, 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 our Support team.

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
5
6
{
"billing_descriptor": {
"name": "Checkout.com",
"city": "London"
}
}