Understanding the AVS response

When you check AVS (Address Verification Service), your response includes an object called avsResults.
See the example below.

Example 200 Response
{
  "token": {...},
  "card": {...},
  "data": {...},
  "avsResults": {
    "matchAddress": true,
    "matchPostal": true,
    "gatewayResponse": {...}
  },
  "cardType": "visa"
}

Match address

The results of the address check.

  • True: The address provided matches the address on file with the card issuer.
  • False: The address provided does not match the address on file with the card issuer.

(In this case, 'address' refers to the street address portion of the billing address.
For example, if the address provided were 123 Sesame St. Manhattan, NY 10128,
matchAddress would compare '123 Sesame St.' with the address on file.)

📘

Note

Card issuers may handle address checks differently.

For your convenience, Nexio returns a simple true or false regardless of the card issuer.

Match postal

The results of the postal code check.

  • True: The postal code provided matches the postal code on file with the card issuer.
  • False: The postal code provided does not match the postal code on file with the card issuer.

(Using the example address above, matchPostal would compare '10128' with the postal code on file.)

Gateway response

This part of the response includes raw details from the gateway's response to the AVS check.
Format may vary by gateway.

📘

Note

A gateway AVS error will not prevent the card token from being saved.

If you received a gateway error during an address verification check, you may want to delete the card token.


Did this page help you?