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 | Address matches, Zip does not. |
E | AVS error. |
N | No match on Address or Zip. |
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: 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. |