2009
Table Of Contents
- Contents
- Introduction
- Downloading, Installing, and Activating
- Simple Payflow Transaction
- Performing Direct Payment Credit Card Transactions
- About Direct Payment Credit Card Processing
- Parameters Used in 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 Credit Transactions
- Submitting Void Transactions
- Recharging to the Same Credit Card (Reference Transactions)
- Using Address Verification Service
- Card Security Code Validation
- Responses to Transaction Requests
- Testing Credit Card Transactions
- Verbosity: Viewing Processor- Specific Transaction Results
- Currency Codes
- Country Codes
- Index
Performing Direct Payment Credit Card Transactions
Parameters Used in Transactions
4
20 Website Payments Pro Payflow Edition Developer’s Guide
COMMENT2 (Optional) Merchant-defined value for reporting and auditing purposes.
Limitations: 128 alphanumeric characters.
CAPTURECOMPLETE (Optional) Indicates if this Delayed Capture transaction is the last capture you intend
to make. The values are:
z Y (default)
z N
NOTE: If CAPTURECOMPLETE is Y, any remaining amount of the original
reauthorized transaction is automatically voided.
Limitations: 12-character alphanumeric string.
CUSTOM (Optional) A free-form field for your own use.
Limitations: 256-character alphanumeric string.
CUSTREF (Optional) Merchant-defined identifier for reporting and auditing purposes. For
example, you can set CUSTREF to INVNUM.
Limitations: 12 alphanumeric characters.
CVV2 (Optional) A code that is printed (not imprinted) on the back of a credit card and used
as partial assurance that the card is in the buyer’s possession.
NOTE: CVV2 values are normalized to Y, N, and X values. The PayPal processor
values are returned when you set VERBOSITY parameter to MEDIUM.
Limitations: Four digits.
EMAIL (Optional) Email address of payer.
Limitations: 127 alphanumeric characters.
INVNUM (Optional) Your own unique invoice or tracking number.
Limitations: 127 alphanumeric characters.
ITEMAMT (Required if L_COSTn is specified) Sum of cost of all items in this order.
ITEMAMT = L_QTY0*LCOST0 + L_QTY1*LCOST1...L_QTYn*L_COSTn
Limitations: Nine numeric characers plus decimal (.) character. No currency symbol.
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.
Limitations: Nine numeric characters plus decimal.
TAXAMT (Required if L_TAXAMTn is specified) Sum of tax for all items in this order.
TAXAMT=L_QTY0*L_TAXAMT0 + L_QTY1*L_TAXAMT1 +...L_QTYn
*L_TAXAMTn
NOTE: You must set CURRENCY to one of the three-character currency codes for any
of the supported PayPal currencies. See CURRENCY in this table for details.
Limitations: Nine numeric characers plus decimal (.) character. No currency symbol.
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.
Nine numeric characters plus decimal.
T
ABLE 4.1 Credit card transaction request parameters
Parameter Description