Developer's Guide

Gateway Developer Guide and Reference 31 July 2012 93
Transaction Responses
BALAMT Response and Stored Value Cards
8
BALAMT Response and Stored Value Cards
Transactions meeting American Express reporting and statement requirements may return
BALAMT when the transaction involves a stored value card. Stored value cards typically are
offered as gift cards, allowing the customer to spend any amount up to the balance remaining
on the card. A card must be active and not compromised for BALAMT to return the card
balance. If the card is used to purchase merchandise exceeding the card balance, American
Express declines the transaction and returns the card balance in BALAMT.
NOTE: Not all processors support BALAMT when a transaction involves a stored value card.
American Express Stored Value Card Example
The following authorization request is for a purchase of 123.00.
TRXTYPE=A&TENDER=C&PWD=x1y2z3&PARTNER=PayPal&VENDOR=SuperMerchant&USER=Supe
rMerchant&ACCT=5555555555554444&EXPDATE=1215&AMT=123.00&BILLTOSTREET=5199 M
APLE&BILLTOZIP=94588
Because the response returns a BALAMT of 99.00, the authorization is declined.
RESULT=12&PNREF=VXYZ01234567&RESPMSG=DECLINED&BALANCE=99.00&AVSADDR=Y&AVSZI
P=N
PNREF
The PNREF is a unique transaction identification number issued by PayPal that identifies the
transaction for billing, reporting, and transaction data purposes. The PNREF value appears in
the Transaction ID column in PayPal Manager reports.
 The PNREF value is used as the ORIGID value (original transaction ID) in delayed capture
transactions (TRXTYPE=D), credits (TRXTYPE=C), inquiries (TRXTYPE=I), and voids
(TRXTYPE=V).
 The PNREF value is used as the ORIGID value (original transaction ID) value in reference
transactions for authorization (TRXTYPE=A) and sale (TRXTYPE=S).
The PNREF value is a 12-character string of printable characters, for example:
X No Response X
All other X
PayPal Processor CVV2 Code
PayPal Processor Code
Description PROCVV2MATCH