Verify credit card address

Click here to learn more about this request

The Secure Payments API supports Address Verification System (AVS) requests. Here's what you need to know about this request:

AVS is used by financial institutions as security measure against card fraud. This system verifies that a provided address matches the address on file at the issuing bank. Some payment processors may require AVS, while others may not.
To send an AVS request, you first need to have the AVS Address Verify ↗ event activated in Secure Payments.
This service incurs a cost per use, but no costs are incurred for activating the event.
The payload of this request can be formatted in two ways: one that includes the full card information, and one that includes only the card token. See our payload samples below for an example of each.

AVS requests return a code that corresponds to a a verification result. Here's a list of the possible AVS codes:

AVS Code	Description
`A`	`Address matches, zipcode does not`
`B`	`Address matches, zipcode is not verified`
`C`	`Neither address or zipcode is verified`
`D`	`Address and zipcode match`
`F`	`Address and zipcode match`
`G`	`Address is not verified`
`I`	`Address is not verified`
`M`	`Address and zipcode match`
`N`	`Neither address or zipcode matches`
`P`	`Zipcode matches, address is not verified`
`Q`	`AVS not available`
`R`	`System unavailable, retry`
`S`	`AVS not supported`
`T`	`Zipcode matches, address does not`
`U`	`No address available to match`
`W`	`Zipcode matches, address does not`
`X`	`Address and zipcode match`
`Y`	`Address and zipcode match`
`Z`	`Zipcode matches, address does not`

Sample Payloads

{
  "cardholder_name": "John Doe",
  "card_number": "4111111111111111",
  "expiration_date": "02/28",
  "address": "900 South 1100 East",
  "city": "SALT LAKE CITY",
  "state": "UT",
  "country": "usa",
  "zipcode": "84105"
}

{
  "token": "QVFJREFIZ0..."
}