Developer's Guide
Table Of Contents
- Payflow Pro Developer’s Guide
- Contents
- Preface
- Introduction
- Installing and Configuring the Payflow APIs
- Performing Credit Card Transactions
- About Credit Card Processing
- Contents of a Transaction Request
- How To Format a Transaction
- Parameters Used in Credit Card Transactions
- Values Required by All Transaction Types
- Submitting Sale Transactions
- Submitting Authorisation/Delayed Capture Transactions
- When To Use Authorisation/Delayed Capture Transactions
- Required Authorisation Transaction Parameters
- Typical Authorisation 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 Voice Authorisation Transactions
- Submitting Credit Transactions
- Submitting Void Transactions
- Submitting Inquiry Transactions
- Recharging to the Same Credit Card (Reference Transactions)
- Submitting Card-Present (SWIPE) Transactions
- Card Security Code Validation
- Responses to Credit Card Transaction Requests
- Testing Payflow Pro Credit Card Transactions
- Activating Your Payflow Pro Account
- Processor Details
- Verbosity: Viewing Processor- Specific Transaction Results
- Additional Reporting Parameters
- XMLPay
- Index
Payflow Pro Developer’s Guide 27
Performing Credit Card Transactions
Submitting Authorisation/Delayed Capture Transactions
The return data for an Authorisation transaction is the same as for a Sale transaction. To
capture the authorised funds, perform a Delayed Capture transaction that includes the value
returned for PNREF, as described in Step 2 on page 27.
EXAMPLE 3.1 Example Authorisation Transaction Parameter String
Issue Authorisation-only Transaction
"TRXTYPE=A&TENDER=C&PWD=x1y2z3&PARTNER=PayPal
&VENDOR=SuperMerchant&USER=SuperMerchant&ACCT=5555555555554444&EXPDATE=0308
&AMT=123.00&COMMENT1=Second purchase
&COMMENT2=Low risk customer&INVNUM=123456789&STREET=5199 MAPLE&ZIP=94588"
E
XAMPLE 3.2 Example Authorisation Response
(Response parameters are described in detail in Chapter 4, “Responses to Credit Card
Transaction Requests”)
RESULT=0&PNREF=VXYZ01234567&RESPMSG=APPROVED&AUTHCODE=123456
&AVSADDR=Y&AVSZIP=N
Step 2 Perform the Delayed Capture transaction
Set ORIGID to the PNREF value returned in the original Authorisation transaction response
string. (There is no need to retransmit the credit card or billing address information—it is
stored at PayPal.)
If the capture succeeds, the amount of the Capture is transferred to the merchant’s account
during the daily settlement process. If the capture does not succeed, the hold on the
cardholder’s open-to-buy is still in effect.
EXAMPLE 3.3 Example Delayed Capture Transaction Parameter String
"TRXTYPE=D&TENDER=C&PWD=x1y2z3&PARTNER=PayPal&VENDOR=SuperMerchant
&USER=SuperMerchant&ORIGID=VXYZ00887892"
E
XAMPLE 3.4 Example Delayed Capture Response
RESULT=0&PNREF=VXYZ00895642&AUTHCODE=25TEST&AVSADDR=Y&AVSZIP=N
Delayed Capture Transaction: Capturing Transactions for Lower Amounts
You can perform a Delayed Capture transaction for an amount lower than the original
Authorisation amount (useful, for example, when you make a partial shipment).
Delayed Capture Transaction: Capturing Transactions for Higher Amounts
You can perform a Delayed Capture transaction for an amount higher than the original
Authorisation amount, however, you are charged for an extra transaction. In addition, the
cardholder’s open-to-buy is reduced by the sum of the original Authorisation-only amount and
the final Delayed Capture amount.