Developer's Guide

Gateway Developer Guide and Reference 07 January 2014 101
Transaction Responses
Address Verification Service Responses From PayPal
8
Address Verification Service Responses From PayPal
The following table compares the detailed response the PayPal processor returns for address
verification to the normalized response value (Y, N, or X) that AVSADDR and AVSZIP return. To
obtain the PayPal processor value, set the VERBOSITY parameter to HIGH. The processor
value is returned in the PROCAVS response parameter.
PAYMENTADVICECODE A processor response code typically returned on declined recurring transactions. Its
purpose is to provide merchants with information and specific instructions on how to
handle the decline. It is the merchant’s responsibility to follow the instructions
provided in order to avoid chargebacks.
For details on the meanings of these codes, see:
https://merchant.paypal.com/us/cgi-bin/?&cmd=_render-
content&content_ID=merchant/cc_compliance_error_codes
NOTE: If a recurring transaction is declined with a returned PAYMENTADVICECODE
value of
03 or 21, it is the merchant's responsibility to stop this recurring
transaction. These two codes indicate that either the account was closed,
fraud was involved, or the cardholder has asked the bank to stop this payment
for another reason. Even if a reattempted transaction is successful, it will
likely result in a chargeback.
TRANSSTATE State of the transaction sent in an Inquiry response. The values are:
 0 = Account Verification (no settlement involved)
 1 = General error state
 3 = Authorization approved
 4 = Partial capture
 6 = Settlement pending (transaction is scheduled to be settled)
 7 =Settlement in progress (transaction involved in a currently ongoing settlement)
 8 = Settled successfully
 9 = Authorization captured (once an authorization type transaction is captured, its
TRANSSSTATE becomes 9)
 10 = Capture failed (an error occurred while trying to capture an authorization
because the transaction was already captured)
 11 = Failed to settle (transactions fail settlement usually because of problems with
the merchant’s processor or because the card type is not set up with the merchant’s
processor)
 12 = Unsettled transaction because of incorrect account information
 14 = For various reasons, the batch containing this transaction failed settlement
 15 = Settlement incomplete due to a charge back
 16 = Merchant ACH settlement failed; (need to manually collect it)
 106 = Unknown Status Transaction - Transactions not settled
 206 = Transactions on hold pending customer intervention
Character length and limitations: 10 integer characters
Field Description