Developer's Guide

Submitting Credit Card Transactions
Using Address Verification Service
6
84 07 January 2014 Gateway Developer Guide and Reference
Example Void Transaction Parameter String
The following is an example void transaction string:
TRXTYPE=V&TENDER=C&PARTNER=PayPal&VENDOR=SuperMerchant&USER=SuperMerchant&P
WD=x1y2z3&ORIGID=VPNE12564395&VERBOSITY=HIGH
Using Address Verification Service
To qualify for the lowest bank rate, pass address verification service information, including the
street address and zip (postal) code.
Address verification service compares the submitted billing street address and zip code with
the values on file at the cardholder’s bank. The response includes values for AVSADDR and
AVSZIP: Y, N, or X for the match status of the customer’s street address and zip code.
Y = match, N = no match, X = cardholder’s bank does not support address verification service.
The address verification service result is for advice only. Banks do not decline transactions
based on the address verification service result. The merchant decides to approve or decline a
transaction. Most US banks and some international banks support the address verification
service.
NOTE: Address verification service checks only for a street number match, not a street name
match, so
123 Main Street returns the same response as 123 Elm Street.
The international address verification service (IAVS) response indicates whether the address
verification service response is international (Y), USA (N), or cannot be determined (X).
NOTE: When you set VERBOSITY to HIGH, the Gateway returns the processor’s raw response
in the
PROCAVS field. To obtain details about the meaning of the response, contact
your merchant bank.
Example Address Verification Service Parameter String
This example request includes the address verification service parameters BILLTOSTREET
and BILLTOZIP:
TRXTYPE=A&TENDER=C&PWD=SuperUserPassword&PARTNER=PayPal&VENDOR=Vendor&USER=
SuperMerchant&&ACCT=5555555555554444&EXPDATE=1215&AMT=123.00&BILLTOSTREET=5
199
Maple&BILLTOZIP=98765
In this example response, the address value matches the value in the bank's records, but the
zip code does not. The AVSZIP response is N.
RESULT=0&PNREF=VXW412345678&RESPMSG=APPROVED&AUTHCODE=123456&AVSADDR=Y&AVSZ
IP=N&IAVS=X