On This Page
REST API

orderInformation. billTo.postalCode

Postal code in the billing address.
The postal code must consist of five to nine digits.
When the billing country is the US, the nine-digit postal code must follow this format: [5 digits][dash][4 digits].
Example
: 12345-6789
When the billing country is Canada, the six-digit postal code must follow this format: [alpha][numeric][alpha][space][numeric][alpha][numeric]
Example
: A1B 2C3
IMPORTANT
This field is optional if your account is configured for relaxed requirements for address data.
Before the postal code is sent to the processor, all non-alphanumeric characters are removed, and if the remaining value is longer than nine characters, the value is truncated starting from the right side.
Credit card networks cannot process transactions that contain non-ASCII characters.
accepts and stores non-ASCII characters correctly and displays them correctly in reports. However, the limitations of the payment card networks prevent
from transmitting non-ASCII characters to the payment card networks. Therefore,
replaces non-ASCII characters with meaningless ASCII characters for transmission to the payment card networks.

Specifications

  • Data Type:
     String
  • Data Length:
     10
  • Data Length:
    • : 9
    • : 9
    • All other processors: 10

Mapping Information

  • REST API Field:
    orderInformation.billTo.postalCode
  • SCMP API Field:
    bill_zip
  • Simple Order API Field:
    billTo_postalCode