Dynamic Descriptors

Specifies the card acceptor descriptor details to send to the cardholder's issuing bank which they can use to describe the transaction on the cardholder's statement, mobile banking etc.

Dynamic Descriptors are specified by the field descriptor of type Hash. descriptor must contain either the fields name and location, or else the field raw (if supported), all having type String.

🚧

Warning:

  • The descriptor details passed on by Fat Zebra may be truncated or formatted differently based on how each cardholder's issuing bank chooses to format and display these values to their customers. An issuing bank may also format the same transaction description differently in different places, e.g. paper statement, digital statement, mobile app, online banking etc.
  • Support for the raw descriptor field is not yet implemented for all upstream processors. Currently, it will only be used when provided in transactions processed by Fiserv.

Field

Type

Description

name

String

The card descriptor name (merchant name) the issuing bank should use to describe the transaction to the cardholder. Maximum 20 characters

location

String

The card descriptor location the issuing bank should use to describe the transaction to the cardholder. Maximum 13 characters

raw

String

A raw descriptor value, provided instead of the name and location, that the issuing bank should use to describe the transaction to the cardholder. Maximum 35 characters Currently only supported if processing via Fiserv

{
  "extra": {
    "descriptor": {
      "name": "Biz Name Pty",
      "location": "Surry Hills"
    }
  }
}
{
  "extra": {
    "descriptor": {
      "raw": "Biz Name Pty Surry Hills NSW AU"
    }
  }
}

Notes for Bill Payment Service Providers/Consumer Bill Payment Services

Merchants who process transactions for bill payments on behalf of other companies, known as Bill Payment Service Providers or Consumer Bill Payment Services, are required to format their descriptor according to scheme requirements, as follows:

BPSP NAME*MERCHANT NAME

In order to do this, the raw descriptor field must be used, as per the following example:

{
  "extra": {
    "descriptor": {
      "raw": "PAYCORP*Clean Co"
    }
  }
}