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
Credit Card Transactions
Parameters Used in Credit Card Transactions
26 Payflow Pro Developer’s Guide
customer with a list of the card types that you accept (in a drop-down list or menu, for
example).
To accept additional credit card types, you must contact your acquiring bank (the merchant
that holds your Internet Merchant Account) and ask them to add the card type to your account.
Upon notification from your Acquirer that you can start accepting the card type, you must add
the card to your Payflow Pro account through PayPal Manager. See PayPal Manager online
help for details.
Parameters Used in Credit Card Transactions
All credit card processors accept the basic parameters described in the table below with one
exception: the PayPal processor does not support SWIPE.
Some processors require additional parameters described in the following sections:
z “Processors Requiring Additional Transaction Parameters” on page 65.
z “Additional Reporting Parameters” on page 141
TABLE 4.1 Credit card transaction request parameters
Parameter Description
ACCT (Required for credit cards) Credit card or purchase card number. For the Pinless debit
TENDER type, ACCT can be the bank account number.
Limitations: This value may not contain spaces, non-numeric characters, or dashes.
For example, ACCT=5555555555554444
EXPDATE (Required) Expiration date of the credit card.
Limitations: mmyy format. For example, 1008 represents November 2008.
AMT (Required) Amount (Default: U.S. based currency).
Limitations: Specify the exact amount to the cent using a decimal point—use 34.00,
not 34. Do not include comma separators—use 1199.95 not 1,199.95. Your processor
and/or Internet Merchant Account provider may stipulate a maximum amount.
9 numeric characters plus decimal.
COMMENT1 (Optional) Merchant-defined value for reporting and auditing purposes.
Limitations: 128 alphanumeric characters.
COMMENT2 (Optional) Merchant-defined value for reporting and auditing purposes.
Limitations: 128 alphanumeric characters.
CVV2 (Optional) A code that is printed (not imprinted) on the back of a credit card. Used as
partial assurance that the card is in the buyer’s possession.
Limitations: 3 or 4 digits.
FIRSTNAME (Optional) Account holder's first name.
Limitations: 30 alphanumeric characters.