Developer's Guide
Table Of Contents
Website Payments Pro Developer’s Guide 37
Performing Direct Payment Credit Card Transactions
Recharging to the Same Credit Card (Reference Transactions)
4
Example Void Transaction Parameter String
This is an example Void transaction parameter string.
EXAMPLE 4.12 Void transaction parameter string
“TRXTYPE=V&TENDER=C&PARTNER=PayPalUK&VENDOR=SuperMerchant&USER=SuperMerchan
t&PWD=SuperUserPassword&ORIGID=EFHP0D426A68”
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 website shop 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 postage 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.
CAUTION! 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 code 117 is returned. See
PayPal Manager online help for instructions on setting reference transactions
and other security features.
Sale and Authorisation 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 Authorisation transaction.
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.