API Version
Product Catalog
Library
List of Errors
The customer has entered an incorrect ZIP/postal code. Ask the customer to try again with the correct ZIP/postal code.

Recommended Customer Message

The ZIP/postal code you entered is incorrect. Try again with the correct ZIP/postal code.

Root Cause

  • Incorrect ZIP/postal code entered: The customer provided a ZIP or postal code that does not match the billing address on file with their card issuer.
  • AVS (Address Verification System) mismatch: The payment gateway detected a mismatch during the address verification process.
  • Outdated billing address: The customer recently changed their address but hasn’t updated it with their bank or card issuer.
  • Formatting errors: The ZIP/postal code was entered in an incorrect format (e.g., missing characters or incorrect country-specific formatting).

Troubleshooting and Solutions

Ask the customer to

  • Verify and re-enter the correct ZIP/postal code associated with the billing address registered with the card issuer.
  • Update the billing address with the bank if it has changed recently.
  • Ensure the ZIP/postal code is entered in the correct format based on the selected country.
  • Display clear and helpful error messages on the payment form to guide users to enter the right Zip / postal code.
  • Retry the transaction after correcting the ZIP/postal code.
  • If issue persists, work with your payment gateway to revisit the AVS rules and relax the validations if needed.