On This Page
REST API

merchantInformation. merchantDescriptor. postalCode

Postal code for your business location.
This field is required for a
Payouts
 original credit transaction (OCT) service request that specifies a deferred OCT processing date and time. See the
processingInformation. payoutOptions. deferredDateTime
 field.
IMPORTANT
Mastercard requires a postal code for any country that uses postal codes. You can provide the postal code in your
Cybersource
 account or you can include this field in your request.
This value might be displayed on the cardholder’s statement.
IMPORTANT
This value may be ignored by your acquiring bank. Contact your acquiring bank for more information about overriding your default merchant descriptor.
If your business is domiciled in the US, you can use a five-digit or nine-digit postal code. A nine-digit postal code must follow this format: [5 digits][dash][4 digits]
Example:
 12345-6789
If your business is domiciled in Canada, use a six-digit postal code. A six-digit postal code must follow this format: [alpha][numeric][alpha][space] [numeric][alpha][numeric]
Example:
 A1B 2C3
When you do not include this value in a PIN debit request, the merchant postal code from your account is used.

Specifications

  • Data Type:
     String
  • Data Length:
     14

Mapping Information

  • REST API Field:
    merchantInformation.merchantDescriptor.postalCode
  • SCMP API Field:
    merchant_descriptor_postal_code
  • Simple Order API Field:
    invoiceHeader_merchantDescriptorPostalCode