Developer's Guide
Table Of Contents
- Payflow Pro Developer’s Guide
- Contents
- Introduction
- Downloading, Installing, and Activating
- Simple Payflow Transaction
- Credit Card Transactions
- Credit Card Features
- About Credit Card Processing
- Parameters Used in Credit Card Transactions
- Submitting Sale Transactions
- Submitting Authorization/Delayed Capture Transactions
- When To Use Authorization/Delayed Capture Transactions
- Required Authorization Transaction Parameters
- Typical Authorization Transaction Parameter String
- Required Delayed Capture Transaction Parameters
- Delayed Capture Transaction: Capturing Transactions for Lower Amounts
- Delayed Capture Transaction: Capturing Transactions for Higher Amounts
- Delayed Capture Transaction: Error Handling and Retransmittal
- Submitting Voice Authorization Transactions
- Submitting Credit Transactions
- Submitting Void Transactions
- Submitting Inquiry Transactions
- Recharging to the Same Credit Card (Reference Transactions)
- Submitting Card-Present (SWIPE) Transactions
- Submitting Purchasing Card Transactions
- Using Address Verification Service
- Processing Platforms Supporting Address Verification Service
- Example Address Verification Service Request Parameter List
- Example Address Verification Service Response
- Card Security Code Validation
- Credit Card Testing
- Responses to Transaction Requests
- Processors Requiring Additional Transaction Parameters
- American Express
- First Data Merchant Services (FDMS) Nashville
- First Data Merchant Services (FDMS) South
- First Data Merchant Services (FDMS) North
- Merchant e-Solutions
- Elavon (Formerly Nova)
- Paymentech
- TSYS Acquiring Solutions
- Performing TeleCheck Electronic Check Transactions
- Submitting Purchasing Card Level 2 and Level 3 Transactions
- About Purchasing Cards
- About Program Levels
- About American Express Purchasing Card Transactions - Phoenix Processor
- American Express Phoenix Purchasing Card Transaction Processing
- First Data Merchant Services (FDMS) Nashville Purchasing Card Transaction Processing
- First Data Merchant Services (FDMS) North Purchasing Card Transaction Processing
- First Data Merchant Services South (FDMS) Purchasing Card Transaction Processing
- Global Payments - Central Purchasing Card Transaction Processing
- Global Payments - East Purchasing Card Transaction Processing
- Merchant e-Solutions Purchasing Card Transaction Processing
- Elavon (Formerly Nova) Purchasing Card Transaction Processing
- Paymentech Salem (New Hampshire) Purchasing Card Transaction Processing
- Paymentech Tampa Level 2 Purchasing Card Transaction Processing
- TSYS Acquiring Solutions Purchasing Card Transaction Processing
- VERBOSITY: Viewing Processor- Specific Transaction Results
- Additional Reporting Parameters
- ISO Country Codes
- Codes Used by FDMS South Only
- XMLPay
- Index
Payflow Pro Developer’s Guide 55
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 A,
“Processors Requiring Additional Transaction Parameters.”
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
AMEXID Unique transaction ID returned when
VERBOSITY = medium or high for tracking
American Express CAPN transactions.
N OTE: American Express CAPN transactions
only: used by merchants who authorize
transactions through the payflow gateway
but settle through a third-party solution.
Numeric 15
AMEXPOSDATA Value returned when VERBOSITY = medium or
high.
N OTE: American Express CAPN transactions
only: used by merchants who authorize
transactions through the payflow gateway
but settle through a third-party solution.
Alpha-
numeric
12
T
ABLE 6.1 Transaction response values(Continued)
Field Description Type Length