Developer's Guide

Table Of Contents
Website Payments Pro Payflow Edition Developer’s Guide 57
Responses to Transaction Requests
BALAMT Response Parameter and Stored Value Cards
6
BALAMT Response Parameter and Stored Value Cards
BALAMT is a parameter that may be returned by transactions meeting Card Acceptance
Processing Network (CAPN) requirements when that transaction involves a stored value card.
Stored value cards typically are offered as “gift” cards, allowing the user to spend any amount
up to the balance remaining on the card. BALAMT returns the balance on the card provided
that the card is active and is not compromised. If the card is used to purchase merchandise
exceeding the card balance, American Express declines the transaction and returns the card
balance in BALAMT.
For details on American Express CAPN request transaction parameters, see Appendix C,
“Submitting Purchasing Card Level 2 and Level 3 Transactions.”
American Express CAPN Stored Value Card Example
The 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=0308&AMT=123.00&STREET=5199
MAPLE&ZIP=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 Value
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.
z 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).
z The PNREF value is used as the ORIGID value (original transaction ID) value in reference
transactions for Authorization (TRXTYPE=A) and Sale (TRXTYPE=S).
NOTE: The PNREF is also referred to as the Transaction ID in PayPal Manager.
AMEXPOSDATA Value returned when VERBOSITY=MEDIUM or VERBOSITY=HIGH..
Character length and limitations: 12 alphanumeic characters
T
ABLE 6.8 Transaction response values
Field Description