Configuration

For configuration code samples, see our Configuration Code for SDKs article.

Set a Descriptor

Dynamic Descriptor is currently only supported by Acquirers Global Payments North America and Allied Irish Banks. Both the Issuer and the Acquirer must support this functionality. Please consult with your account manager or support agent before using.

info
// Create the card object
CreditCardData card = new CreditCardData();
card.setNumber("4111111111111111");
card.setExpMonth(12);
card.setExpYear(2025);
card.setCvn("123");
card.setCardHolderName("Joe Smith");

try {
    card
        .authorize(new BigDecimal("10"))
        .withCurrency("USD")
        .withDynamicDescriptor("ALTERNATIVE DBA")
        .execute();
} catch (ApiException e) {
    // TODO: add your error handling here
}
<?php

// create the card object
$card = new CreditCardData();
$card->number = "4111111111111111";
$card->expMonth = 12;
$card->expYear = 2025;
$card->cvn = "131";
$card->cardHolderName = "Joe Smith";

try {
    $response = $card->authorize(10)
        ->withCurrency('USD')
        ->withDynamicDescriptor('ALTERNATIVE DBA')
        ->execute();
} catch (ApiException $e) {
    // TODO: add your error handling here
}
// Create the card object
CreditCardData card = new CreditCardData
{
	Number = "4111111111111111",
	ExpMonth = 12,
	ExpYear = 2025,
	Cvn = "123",
	CardHolderName = "Joe Smith"
};

try
{
	var authorization = card.Authorize(10m)
		.WithCurrency("USD")
		.WithDynamicDescriptor("ALTERNATIVE DBA")
		.Execute();
}
catch (Exception ex)
{
	// TODO: add your error handling here
}

If you’re using this functionality and no descriptor is flagged, we’ll use your Global Payments merchant name as the default. The merchant name is set when you create or update your account with us.

Request syntax

Type “O” indicates that the field is optional.

Element/Field Category Format Type Length Description

Charge Description

string

alphanumeric

O

25

Allowed characters:
a-z A-Z 0-9 [space] / -
French-accented

 

Internal Title
SDK
Show Content Nav
On