Developer's Guide

Table Of Contents
Credit Card Transactions
Recharging to the Same Credit Card (Reference Transactions)
40 Payflow Pro Developer’s Guide
TRXTYPE=I&TENDER=C&PARTNER=PayPal&VENDOR=SuperMerchant&USER=SuperMerchant&P
WD=x1y2z3&CUSTREF=Inv00012345
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.
NOTE: The PNREF returned in the original transaction is valid for use in reference transactions
for a period of 12 months. A PNREF returned by Account Verification also can be used
in a reference transaction.
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 Authorization 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 Protection
Services 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.