Checking with Address Verification Service

Address Verification Service (AVS) is a service that allows you to check whether a customer who makes a payment by a bank card is the actual cardholder. The AVS check is performed by matching the address specified by a customer while performing a payment with the cardholder address according to the bank card Issuer.

AVS check is mandatory for payments committed in the UK, and optional in the USA, Australia, Canada and New Zealand. Therefore, it may be required additional mandatory parameters in the request for payment : the postcode avs_post_code and the address avs_street_address of a customer. You can send these parameters in a parameters clarification request, for more information, see Additional payment information submission. If the data does not passed, not pass validation or empty, you receive the appropriate decline code and message. The result of the AVS check is sent in the callback parameter avs_result.

There are two schemes of work with AVS: sending the AVS parameters in each payment request or sending the AVS parameters in a clarification request, if AVS is enabled for the country of the card Issuer in the project settings.

Note: The requirement to provide AVS parameters persists even if the payment is made by a token or a saved bank card.

Results of checking with AVS

Below is a table of possible codes that can be returned, with additional information and descriptions for them.

Table 1. Codes of results of checking with AVS
Code Value Description
Z, P, W Partial match Post code matches, but street address does not
A, B Partial match Street address matches, but post code does not
F, D, M, Y, X Exact match Address and post code match
N No match Street address and post code do not match
U, S, C, G, I Address information unavailable. Address information is unavailable for this account or an issuing bank does not support the AVS
R System unavailable System is unavailable at the moment, retry
Table 2. AVS response codes divided by international payment systems
VISA F, X, D, M, Y, A, B, Z, P, W, N, G, U, S, C, I, R, U
MasterCard X, Y, A, Z, W, N, U, S, R, U