REST API

merchantInformation. merchantDescriptor. country

Country code for your business location.
This field is available only for the
Visa Platform Connect
processor.
Use the standard ISO standard country codes.
When you do not include this value in your request,
Cybersource
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
REST
merchantInformation.merchantDescriptor.administrativeArea
API field.
You must include this field and the
REST
aggregatorInformation.subMerchant.country
API field in your authorization and capture request if you use the Foreign Retail Indicator.
When this field and the
REST
aggregatorInformation.subMerchant.country
API field are not set to the same value, the Foreign Retail Indicator is set to
F
.
When this field and the
REST
aggregatorInformation.subMerchant.country
API field are set to the same value, the Foreign Retail Indicator is set to a space character.
The Foreign Retail Indicator field value corresponds to the data in the following TC 33 capture file:
  • Record: CP01 TCR8
  • Position: 166–168
  • Field: Foreign Retail Indicator
This field is required for a
Payouts
original credit transaction (OCT) service request that specifies a deferred OCT processing date and time. See the
REST
processingInformation. payoutOptions. deferredDateTime
API field.
To support Visa Direct transactions in Original Credit Transactions destined to issuers in Australia or Canada, you must include additional merchant address data in the authorization request:
  • Field 43—Card Acceptor Name/Location
  • Field 59—National Point-of-Service Geographical Data
  • Field 104, Usage 2—Transaction-Specific Data in TLV format, Dataset ID 56—Additional Acceptance Information, Tag 81—Acceptor Legal Business Name
To process Faster Refund Original Credit Transactions (OCTs) in AP and the EU, include these fields in the request:
  • Transaction Type
    • Record: Field 3
    • Positions: 1-2
  • Transaction Amount
    • Record: Field 4
  • Card Acceptor Name or Location
    • Record: Field 43
  • Transaction Identifier
    • Record: Field 62.2 (in bitmap format)
  • Message Reason Code
    • Record: Field 63.3
  • Acceptor Legal Business Name
    • Record: 104, Usage 2—Transaction-Specific Data (in TLV format)
    • Dataset ID: 56
    • Tag: 81
  • Business Application Identifier (BAI)
    • Record: 104, Usage 2—Transaction-Specific Data (in TLV format)
    • Dataset ID: 57
    • Tag: 01
  • Visa Merchant Identifier
    • Record: 126.5

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