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
Submitting Authorization/Delayed Capture Transactions
4
24 Website Payments Pro Payflow Edition Developer’s Guide
association rules recommend that you use an Authorization and a Delayed Capture transaction.
For details, see “Submitting Authorization/Delayed Capture Transactions” on page 24. If you
need to recharge a credit card and you are not storing the credit card information in your local
database, you can perform a new reference transaction based on a Sale transaction. For details,
see “Recharging to the Same Credit Card (Reference Transactions)” on page 32.
Additional Parameters For Sale Transactions
To perform a Sale transaction, you are required to pass the following parameters:
z ACCT
z AMT
z EXPDATE
Typical Sale Transaction Parameter String
The following is a typical PARMLIST string passed in a Sale transaction.
TRXTYPE=S&TENDER=C&USER=user&PWD=password&PARTNER=partner&ACCT=510510510510
5100&EXPDATE=1209&AMT=99.06&COMMENT1=Reservation&FIRSTNAME=John&LASTNAME=Jo
nes&STREET=123 Main St.&CITY=San
Jose&STATE=CA&ZIP=123451234&COUNTRY=US&CVV2=123&CUSTIP=0.0.0.0
Note that, besides the required parameters that you pass in a Sale transaction, this string
includes other typical parameters. PayPal recommends that you include the account holder’s
FIRSTNAME and LASTNAME. PayPal also recommends including CUSTIP to help detect
possible fraud. The COMMENT1 field helps to track transaction information. The customer’s
street address (STREET) and ZIP should be passed to use the Address Verification Service.
CVV2 is needed for card security code validation. For details on Address Verification Service
and card security code, see the following sections:
z “Using Address Verification Service” on page 34
z “Card Security Code Validation” on page 35
Submitting Authorization/Delayed Capture Transactions
An Authorization (TRXTYPE=A) transaction places a hold on the cardholder’s open-to-buy
limit, lowering the cardholder’s limit by the amount of the transaction. It does not transfer
funds.
One or more Delayed Capture (TRXTYPE=D) transactions are performed after an Authorization
to capture the original Authorization amount. You can perform up to 10 partial captures for a
single authorization provided the buyer is in good standing. A partial capture keeps the funds
in a Pending status. A Delayed Capture is scheduled for settlement during the next settlement
period.