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
Website Payments Pro Payflow Edition Developer’s Guide 29
Performing Direct Payment Credit Card Transactions
Submitting Credit Transactions
4
cancel an order from your business. To refund her money, you credit her credit card by
submitting a non-referenced Credit transaction.
Guidelines and parameter requirements for Credit transactions differ depending on whether or
not non-referenced credits are allowed.
Non-Referenced Credits Not Allowed
When non-referenced credits are not allowed (the setting recommended by PayPal), then
Credit transactions are permitted only against existing Sale, Delayed Capture, and Voice
Authorization transactions. To submit a Credit transaction when non-referenced credits are not
allowed, you must pass the following parameter:
ORIGID
Set the value of ORIGID to the PNREF value returned for the original transaction. (PNREF is
displayed as the Transaction ID in PayPal Manager reports. If you do not specify an amount,
then the amount of the original transaction is credited to the cardholder.
Non-Referenced Credits Allowed
When non-referenced credits are allowed, then Credit transactions are permitted in any
amount up to the transaction limit for the credit card account that you specify. To submit a
Credit transaction when non-referenced credits are not allowed, you must pass values for the
following parameters:
z ACCT
z EXPDATE
z AMT
IMPORTANT:The default security setting for Payflow Pro accounts is Allow
non-referenced credits = No, so sending the ORIGID is the preferred method
for performing Credit transactions. Using the ACCT, EXPDATE, or AMT
parameters for such accounts leads to RESULT value 117 (failed the security
check). For information on setting the security settings, see PayPal Manager
online help.
Fields Copied From the Original Transaction into the Credit Transaction
The following fields are copied from the original transaction into the Credit transaction (if
they exist in the original transaction). If you provide a new value for any of these parameters
when submitting the Credit transaction, then the new value is used. (Exceptions are ACCT,
EXPDATE, and SWIPE. These parameters retain their original values).
TABLE 4.4 Credit required parameter
Parameter Description
ORIGID (Required by some transaction types) ID of the original transaction that is being
referenced. This ID is returned by the PNREF parameter and appears as the
Transaction ID in PayPal Manager reports.
Limitations: Case sensitive.