On This Page
REST API

merchantInformation. merchantDescriptor. country

Country code for your business location.
Use the standard ISO standard country codes.
When you do not include this value in your request,
uses the merchant country from your account.
This value must consist of English characters.
This value might be displayed on the cardholder’s statement.
IMPORTANT
This value might be ignored by your acquiring bank. Contact your acquiring bank for more information about overriding your default merchant descriptor.
If your business is located in the US or Canada and you include this field in a request, you must also include the
merchantInformation.merchantDescriptor.administrativeArea
 field.
This field is required for a
original credit transaction (OCT) service request that specifies a deferred OCT processing date and time. See the
processingInformation.payoutOptions.deferredDateTime
 field.
For marketplace transactions, include this field and the
aggregatorInformation.subMerchant.country
 field in the transaction request. The marketplace is the merchant and the retailer is the sub‑merchant. When the field values do not match, the transaction is identified as a foreign retail transaction in the
on the transactions details page.

Specifications

  • Data Type:
     String
  • Data Length:
     2

Mapping Information

  • REST API Field:
    merchantInformation.merchantDescriptor.country
  • SCMP API Fields:
    • merchant_descriptor_country
    • pa_merchant_country_code
  • Simple Order API Fields:
    • invoiceHeader_merchantDescriptorCountry
    • payerAuthEnrollService_merchantCountrycode