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 (Refund) 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
- Information for the PayPal Acquirer
- 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
- Cielo Payments, 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
- Payflow Header Parameters
- Submitting Purchasing Card Level 2 and 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
- Cielo Payments 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: Processor-Specific Transaction Results
- Country Codes
- Codes Used by FDMS South Only
- Additional Processor Information
- Payflow Link Migration
- Payflow Gateway MagTek Parameters
- Payflow Gateway FAQs
Content
8 07 January 2014 Gateway Developer Guide and Reference
Soft Merchant Descriptor Parameters . . . . . . . . . . . . . . . . . . . . . . . . . .138
WorldPay Additional Credit Card Parameters . . . . . . . . . . . . . . . . . . . . . . . .140
Chapter B TeleCheck Electronic Check Processing . . . . . . . . . 141
TeleCheck NFTF Overview of Services . . . . . . . . . . . . . . . . . . . . . . . . . . .141
TeleCheck NFTF Processing Overview . . . . . . . . . . . . . . . . . . . . . . . . . . .141
NFTF Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .141
NFTF Processing Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . .143
NFTF Guidelines. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .143
TeleCheck Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .144
Required TeleCheck Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . .145
Testing TeleCheck Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .147
Example Test Transaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .147
Preparing for TeleCheck Production Transactions . . . . . . . . . . . . . . . . . . . . . .148
Responses to TeleCheck Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . .148
Transaction Responses Common to All Tender Types . . . . . . . . . . . . . . . . .148
Response Code Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .149
Sale Response Code Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .149
Adjustment Code Values. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .150
Response Codes For Status Response Packets . . . . . . . . . . . . . . . . . . . .150
TeleCheck Authorization Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . .151
Authorization – Sales Consent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .151
Authorization – Sales Decline/Error . . . . . . . . . . . . . . . . . . . . . . . . . . .154
Chapter C Payflow Header Parameters . . . . . . . . . . . . . . . . 155
Sending Requests Directly to PayPal Bypassing Payflow . . . . . . . . . . . . . . . . . .155
Posting Transactions Directly Without the Payflow SDK. . . . . . . . . . . . . . . . . . .156
The Payflow Message Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . .156
Payflow Message Protocol Headers. . . . . . . . . . . . . . . . . . . . . . . . . . .157
Transaction Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .158
Integrator-Provided Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .160
Chapter D Submitting Purchasing Card Level 2 and 3 Transactions . 163
About Purchasing Cards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .163
About Program Levels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .163
Accepted BIN Ranges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .164
About American Express Purchasing Card Transactions . . . . . . . . . . . . . . . . . .164