Developer's Guide
Table Of Contents
- Content
- Preface
- Introducing the Gateway Checkout Solutions
- Secure Token
- Configuring Hosted Checkout Pages
- Payflow SDK
- Sending a Simple Transaction to the Server
- Submitting Credit Card Transactions
- Obtaining an Internet Merchant Account
- About Credit Card Processing
- Credit Card Features
- Planning Your Gateway Integration
- Core Credit Card Parameters
- Submitting Account Verifications
- Submitting Authorization/Delayed Capture Transactions
- Submitting Balance Inquiry Transactions
- Submitting Card Present (SWIPE) Transactions
- Submitting Credit Transactions
- Submitting Inquiry Transactions
- When To Use an Inquiry Transaction
- Required Parameters When Using the PNREF
- Inquiry Transaction Parameter String Using the PNREF
- Required Parameters When Using the CUSTREF
- Inquiry Transaction Parameter String Using the CUSTREF
- Required Parameters When Using the Secure Token
- Inquiry Parameter String Using the Secure Token
- Submitting Partial Authorizations
- Submitting Purchasing Card Transactions
- Submitting Reference Transactions (Tokenization)
- Submitting Sale Transactions
- Submitting Soft Merchant Information
- Submitting Voice Authorization Transactions
- Submitting Void Transactions
- Using Address Verification Service
- Using Card Security Code
- Testing Transactions
- Transaction Responses
- Processors Requiring Additional Transaction Parameters
- American Express Additional Credit Card Parameters
- Elavon Additional Credit Card Parameters
- First Data Merchant Services Nashville, Additional Credit Card Parameters
- First Data Merchant Services North, Additional Credit Card Parameters
- Heartland, Additional Credit Card Parameters
- Litle Additional Credit Card Parameters
- Merchant e-Solutions, Additional Credit Card Parameters
- Paymentech Salem (New Hampshire) Additional Credit Card Parameters for American Express
- PayPal Credit Card Transaction Request Parameters
- SecureNet Additional Credit Card Parameters for American Express
- Vantiv Additional Credit Card Parameters
- WorldPay Additional Credit Card Parameters
- TeleCheck Electronic Check Processing
- Submitting Purchasing Card Level 2 and Level 3 Transactions
- About Purchasing Cards
- About Program Levels
- About American Express Purchasing Card Transactions
- American Express Purchasing Card Transaction Processing
- Elavon (Formerly Nova) 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
- Heartland Purchasing Card Transaction Processing
- Litle Purchasing Card Transaction Processing
- Merchant e-Solutions Purchasing Card Transaction Processing
- Paymentech Salem (New Hampshire) Purchasing Card Transaction Processing
- Paymentech Tampa Level 2 Purchasing Card Transaction Processing
- SecureNet Purchasing Card Transaction Processing
- TSYS Acquiring Solutions Purchasing Card Transaction Processing
- Vantiv Purchasing Card Transaction Processing
- WorldPay Purchasing Cards Transaction Processing
- VERBOSITY: Viewing Processor- Specific Transaction Results
- ISO Country Codes
- Codes Used by FDMS South Only
- PayPal Acquirer
- Additional Processor Information
- Payflow Link Migration
Content
4 31 July 2012 Gateway Developer Guide and Reference
Using a Secure Token and Dynamically Passing Form Post Variables . . . . . . . . . . . 36
Silent Posts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Force Silent Post Confirmation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Data Returned by the Silent Post Features . . . . . . . . . . . . . . . . . . . . . . . 39
Chapter 4 Payflow SDK . . . . . . . . . . . . . . . . . . . . . . . . .41
Preparing the Payflow Gateway Client Application . . . . . . . . . . . . . . . . . . . . . 41
Activating Your Payflow Gateway Account. . . . . . . . . . . . . . . . . . . . . . . . . . 42
Host URL Addresses. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Chapter 5 Sending a Simple Transaction to the Server . . . . . . . .43
About Name-Value Pairs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Using Special Characters In Values . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Name-Value Parameter Syntax Guidelines . . . . . . . . . . . . . . . . . . . . . . . 44
Do Not URL Encode Name-Value Parameter Data . . . . . . . . . . . . . . . . . . . 44
Payflow Connection Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
User Parameter Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Sale Transaction Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Typical Sale Transaction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Formatting Payflow Gateway Transactions . . . . . . . . . . . . . . . . . . . . . . . . . 46
Chapter 6 Submitting Credit Card Transactions . . . . . . . . . . . .47
Obtaining an Internet Merchant Account . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
About Credit Card Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Credit Card Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Planning Your Gateway Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Complying With E-commerce Indicator . . . . . . . . . . . . . . . . . . . . . . . . . 50
Handling Credit Card Type Information . . . . . . . . . . . . . . . . . . . . . . . . . 50
Core Credit Card Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Submitting Account Verifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
When To Use Account Verifications . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Required Account Verification Parameters . . . . . . . . . . . . . . . . . . . . . . . 54
Example Account Verification String . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Submitting Authorization/Delayed Capture Transactions . . . . . . . . . . . . . . . . . . 55
When to Use Authorization/Delayed Capture Transactions . . . . . . . . . . . . . . . 55
Required Authorization Transaction Parameters . . . . . . . . . . . . . . . . . . . . 56
Typical Authorization Transaction Parameter String . . . . . . . . . . . . . . . . . . . 56