Dynamic Descriptors

Owned by Tom Knuth
Last updated: Oct 13, 2023 by Salim Ali
2 min read

The term "gateway descriptor" refers to a short text description that appears on a customer's credit card statement or bank statement when a transaction is processed through a payment gateway.

Some gateways allow the descriptor to be set from the application. These gateways are:

Adyen

Affirm

Computop

Computop3DSV2

Concardis

Corefy

Everyware

First Cash

First Cash3DS

Green Money

Hipay

Kalixa

MegaCharge

Moonlight Payments

NovalNet

PayArc

PayCom

Paynetworx

Payon Gateway

PayPalCommerce

Quick Pay

Skrill

StripeV2

Sure Pay

VantivV2

WorldpayV2

The descriptor is sent conditionally for:

BlueSnap (if the order is not native 3DS)
CheckoutV2 (bancontact, EPS, giropay, SEPA Debit only)
PagBrasil (credit cards only)
SquareV2 (credit cards only]
NMI (if the sendDescriptor box is checked on gateway setup)

After you select send descriptor, enable this setting on nmi's side.

 

There are 3 ways to set descriptors:

1. Enter a descriptor on the Gateway setup. This is required. Obtain this from your merchant provider.

CRM > Gateways > Gateway List > edit

 

2. Enter a descriptor on each campaign product. This is optional. A campaign product descriptor will override the gateway descriptor. If there are multiple products on the order then the transaction descriptor will be set from the first product with a descriptor.

 

3. Import an order with a custom descriptor. Use the customDescriptor parameter on Import Order or Import Upsale API. A custom descriptor will override both gateway and product descriptor. The custom descriptor is not saved on the order. The custom descriptor is not used on rebills. Subsequent viewing of the order in CRM will not display the custom descriptor.

API Documentation