The Address Verification System (AVS) is an anti-fraud function that verifies the billing address of the cardholder.
The AVS system compares the billing address provided by the consumer during his purchase with that recorded by his bank for the use of his credit card. AVS exists only on a limited number of acquirers and card types and only for a limited set of countries.
Compatible buyers are: Barclaycard, Worldpay and EMS.
Eligible cards are: Visa, Mastercard, American Express.
AVS is active in Great Britain, Canada and the United States.
To use AVS, you must provide the consumer's full address using the billingAddress element of the payment authorization request, as shown below:
You must use version 17 or later of the Payline API to use the AVS feature.
When you submit the billingAddress object , provide the following:
street1 - fill in the number and street name.
street2 - required, if available.
cityName - not required
zipCode - always necessary.
country - not required
state - not required
You must make sure to send in the street1 and street2 elements of the billing address the numeric symbols for the digits. Example: " 1 rue des Beaumonts" and not " a street Beaumonts".
AVS response codes are specific to card networks and acquirers. In order to simplify the use of AVS, we have mapped these different response codes to our generic response codes.
Thus the result of the AVS is returned in the element avs composed of two fields:
result - result code generic AVS
resultFromAcquirer - AVS specific result code for each acquirer
The values of the AVS response code are as follows:
Address match, not postal code
Correspondence of the postal code, not the address
Check not carried out (no data, function not supported, technical problem, timeout, ...)
You can test the AVS using the following postal codes:
Result code AVS