ResponseAVSResult Property
Contains the Address Verification System result code.
Syntax
__property String ResponseAVSResult = {read=FResponseAVSResult, write=FSetResponseAVSResult};
Default Value
""
Remarks
Contains the Address Verification System result code. This one character property contains the Address Verification Service (AVS) result code. An AVS result code can provide additional information concerning the authentication of a particular transaction for which cardholder address verification was requested. An AVS result code of "0" will be returned in the response message when no address verification has been requested. The value returned should be stored for later retrieval, as it may be required when voiding or refunding a transaction. Valid AVS response codes are listed below, and are identical across all Gateway (note that some gateways do not return an AVS response).
ResponseAVSResult | Description |
A | Address matches, Zip does not. |
E | AVS error. |
G | Non-U.S. issuing bank does not support AVS. |
N | No match on Address or CustomerZip. |
P | AVS not applicable for this transaction. |
R | Retry - Issuer system unavailable. |
S | Service not supported by issuer. |
U | Address information is unavailable. |
W | Nine digit Zip matches, Address does not. |
X | Exact AVS match, nine digit Zip. |
Y | Exact AVS match, five digit Zip. |
Z | Five digit Zip matches, Address does not. |
Note: Some gateways use their own response codes instead of those in the above table; those response codes are detailed below for such gateways.
Adyen
For Adyen, this property will contain the following possible values:
0 | Unknown |
1 | Address matches, postal code doesn't |
2 | Neither postal code nor address match |
3 | AVS unavailable |
4 | AVS not supported for this card type |
5 | No AVS data provided |
6 | Postal code matches, address doesn't match |
7 | Both postal code and address match |
8 | Address not checked, postal code unknown |
9 | Address matches, postal code unknown |
10 | Address doesn't match, postal code unknown |
11 | Postal code not checked, address unknown |
12 | Address matches, postal code not checked |
13 | Address doesn't match, postal code not checked |
14 | Postal code matches, address unknown |
15 | Postal code matches, address not checked |
16 | Postal code doesn't match, address unknown |
17 | Postal code doesn't match, address not checked |
18 | Neither postal code nor address were checked |
American Payment Solutions
For American Payment Solutions, this property will contain the following possible values:
X | Exact match, 9-character numeric ZIP |
Y, D, or M | Exact match, 5-character numeric ZIP |
2 or 6 | Exact match, 5-character numeric ZIP, customer name |
A or B | Address match only |
3 or 7 | Address, customer name match only |
W | 9-character numeric ZIP match only |
Z, P, or L | 5-character ZIP match only |
1 or 5 | 5-character ZIP, customer name match only |
N or C | No address or ZIP match only |
4 or 8 | No address or ZIP or customer name match only |
U | Address unavailable |
G or I | Non-U.S. issuer does not participate |
R | Issuer system unavailable |
E | Not a mail/phone order |
S | Service not supported |
0, O, or B | AVS not available |
Barclay
For Barclay, the property will contain the following possible values:
YY | Address and zip code or postal code match |
YN | Address matches only |
NY | Zip code or postal code matches |
NN | Neither address nor zip code or postal code matches; address is not parsable |
UU | Address information is unavailable, service is unavailable, or Error; Unknown |
Blank | No AVS performed |
BlueSnap
For BlueSnap, the property will contain a 3-character string (if AVS checks were done), which contains the AVS checks for the following properties:
1st Character | Name AVS check |
2nd Character | Address AVS check |
3rd Character | Postal/Zip Code AVS check |
The possible values for each result character are:
M | Matches |
N | Does not match |
U | Could not be verified |
HSBC
For HSBC, the property will contain the following possible values:
YY | Address and zip code or postal code match |
YN | Address matches only |
NY | Zip code or postal code matches |
NN | Neither address nor zip code or postal code matches; address is not parsable |
UU | Address information is unavailable, service is unavailable, or Error; Unknown |
FF | Issuer does not participate in AVS |
Blank | No AVS performed |
PayTrace
For PayTrace, the property will contain the following possible values:
Full Exact Match | |
Address Match Only | |
Zip Match Only | |
No Match | |
Address Unavailable | |
Non-US Issuer does not participate | |
Issuer System Unavailable | |
Not a Mail/Phone Order | |
Service Not Supported |
QBMS
For the QBMS gateway, the ResponseAVSResult property will contain the result for the street address, a comma, and then the result for the zip code. The values returned are "Pass", "Fail", and "NotAvailable". Therefore, an ResponseAVSResult of "Fail,Pass" means that the street address failed validation, but the zip code passed.
DataCash
For DataCash, the property will contain the following possible values (of which correspond to both AVS and CVV checks):
NO DATA MATCHES | |
ADDRESS MATCH ONLY | |
SECURITY CODE MATCH ONLY | |
ALL MATCH | |
DATA NOT CHECKED |
Stripe
For Stripe, the property will contain the following possible values:
Pass | The first address line or zip code provided is correct. |
Fail | The first address line or zip code provided is incorrect. |
Unavailable | The customer's bank did not check the first address line or zip code provided. |
Unchecked | The first address line or zip code was provided but has not yet been checked. |
Worldpay
For Worldpay, the property will contain a 4-character string, which contains the AVS checks for the following properties:
1st Character | Card Verification Value (CVV) check |
2nd Character | Postal/Zip Code AVS check |
3rd Character | Address AVS check |
4th Character | Country Comparison check |
The possible values for each result character are:
0 | Not Supported. |
1 | Not Checked. |
2 | Matched. |
4 | No Match. |
8 | Partial Match. |
Worldpay Online
For Worldpay Online, the property will contain one of the following:
Value | Description |
APPROVED | The supplied street and postal code details fully matched the payment provider's records |
PARTIAL APPROVED | One of the supplied street or postal code details did not match the payment provider's records |
NOT SENT TO ACQUIRER | Problem with acquirer - possibly no AVS support |
NO RESPONSE FROM ACQUIRER | Problem with acquirer - possibly no AVS support |
NOT CHECKED BY ACQUIRER | The acquirer did not check the address details |
NOT SUPPLIED BY SHOPPER | Missing, incomplete or invalid address details in the order prevented the address from being checked |
FAILED | Both street and postal code details did not match the payment provider's records |
This property is read-only and not available at design time.
Data Type
String