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
Recharging to the Same Credit Card (Reference Transactions)
4
32 Website Payments Pro Payflow Edition Developer’s Guide
Recharging to the Same Credit Card (Reference Transactions)
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 reference transaction. A reference transaction takes the
existing credit card information that is on file and reuses it.
When To Use a Reference Transaction
Say that Joe Smith purchases a holiday gift from your web site store and requests that it be sent
by UPS ground service. That evening, Joe becomes concerned that the item might not arrive in
time for the holiday. So he calls you to upgrade shipping to second-day air. You obtain his
approval for charging an extra $10 for the upgrade. In this situation, you can create a reference
transaction based on the original Sale and charge an additional $10 to Joe’s credit card without
having to ask him again for his credit card information.
IMPORTANT:As a security measure, reference transactions are disallowed by default. Only
your account administrator can enable reference transactions for your
account. If you attempt to perform a reference transaction in an account for
which reference transactions are disallowed, RESULT value 117 is returned.
See PayPal Manager online help for instructions on setting reference
transactions and other security features.
Sale and Authorization transactions can make use of a reference transaction as a source of
transaction data. PayPal looks up the reference transaction and copies its transaction data into
the new Sale or Authorization transaction. With the exception of dollar amount data, which
triggers a filter if out of range, reference transactions are not screened by fraud filters.
IMPORTANT:When PayPal looks up the reference transaction, neither the transaction being
referenced nor any other transaction in the database is changed in any way.
That is, a reference transaction is a read-only operation—only the new
transaction is populated with data and acted upon. No linkage is maintained
between the reference transaction and the new transaction.
You can also initiate reference transactions from PayPal Manager. See PayPal Manager online
help for details.
Transaction Types that Can Be Used as the Original Transaction
You can reference the following transaction types to supply data for a new Sale or
Authorization transaction:
z Sale
z Authorization (To capture the funds for an approved Authorization transaction, be sure to
perform a Delayed Capture transaction—not a Reference transaction.)
z Vo id
z Delayed Capture