ResponseAVS Property
Contains the Address Verification System result code.
Data Type
StringDefault Value
""Remarks
This one character field 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 Gateways (note that some gateways do not return an AVS response).
Code | Description |
A | CustomerAddress matches, CustomerZip does not. |
E | AVS error. |
N | No match on CustomerAddress 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 CustomerZip matches, CustomerAddress does not. |
X | Exact AVS match, nine digit CustomerZip. |
Y | Exact AVS match, five digit CustomerZip. |
Z | Five digit CustomerZip matches, CustomerAddress does not. |
Note: The above table does not apply to the WorldPay gateway. For Worldpay, this property will contain a 4-character string, which contains the AVS checks for the following fields:
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. |