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 5
Contents
Fields Copied From Reference Transactions . . . . . . . . . . . . . . . . . . . . . . 40
Example Reference Transaction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Submitting Card-Present (SWIPE) Transactions. . . . . . . . . . . . . . . . . . . . . . . 41
Supported Processing Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Card-present Transaction Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Submitting Purchasing Card Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Using Address Verification Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Processing Platforms Supporting Address Verification Service . . . . . . . . . . . . . . . 43
Example Address Verification Service Request Parameter List . . . . . . . . . . . . . . . 44
Example Address Verification Service Response . . . . . . . . . . . . . . . . . . . . . . 44
Card Security Code Validation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Processing Platforms and Credit Cards Supporting Card Security Code . . . . . . . . 45
Chapter 5 Credit Card Testing . . . . . . . . . . . . . . . . . . . . .47
Testing Guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Credit Card Numbers Used for Testing . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Result Values in Responses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Testing Result Values in Responses. . . . . . . . . . . . . . . . . . . . . . . . . . . 48
RESULT Values Returned Based on Transaction Amount. . . . . . . . . . . . . . . . . . 48
Alternative Methods for Generating Specific RESULT Values . . . . . . . . . . . . . . 49
Testing Address Verification Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Testing Card Security Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Chapter 6 Responses to Transaction Requests . . . . . . . . . . . .53
Contents of a Response to a Credit Card Transaction Request . . . . . . . . . . . . . . . 53
BALAMT Response Parameter and Stored Value Cards . . . . . . . . . . . . . . . . . . 55
American Express CAPN Stored Value Card Example . . . . . . . . . . . . . . . . . 55
PNREF Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
PNREF Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
RESULT Values and RESPMSG Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
RESULT Values for Transaction Declines or Errors . . . . . . . . . . . . . . . . . . . 56
RESULT Values for Communications Errors . . . . . . . . . . . . . . . . . . . . . . 62
Appendix A Processors Requiring Additional Transaction Parameters .65
American Express . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
American Express Additional Credit Card Parameters (CAPN) . . . . . . . . . . . . . 66
American Express Additional Credit Card Parameters (Legacy) . . . . . . . . . . . . 71