ResponseAVSResult Property

Contains the Address Verification System result code.

Syntax

char* GetResponseAVSResult();

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: The above table does not apply to the WorldPay gateway, HSBC gateway, Adyen gateway, Barclay gateway, or PayTrace.

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.

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

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

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

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

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.

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

This property is read-only and not available at design time.

Data Type

String