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
Responses to Credit Card Transaction Requests
PNREF Value
4
42 Payflow Pro Developer’s Guide
PNREF Value
The PNREF is a unique transaction identification number issued by PayPal that identifies the
transaction for billing, reporting, and transaction data purposes. The PNREF value appears in
the Transaction ID column in PayPal Manager reports.
z The PNREF value is used as the ORIGID value (original transaction ID) in Delayed
Capture transactions (TRXTYPE=D), Credits (TRXTYPE=C), Inquiries (TRXTYPE=I),
and Voids (TRXTYPE=V).
z The PNREF value is used as the ORIGID value (original transaction ID) value in reference
transactions for Authorisation (TRXTYPE=A) and Sale (TRXTYPE=S).
N OTE: The PNREF is also referred to as the Transaction ID in PayPal Manager.
PNREF Format
The PNREF is a 12-character string of printable characters, for example:
z VADE0B248932
z ACRAF23DB3C4
N OTE: Printable characters also include symbols other than letters and numbers such as the
question mark (?). A PNREF typically contains letters and numbers only.
The PNREF in a transaction response tells you that your transaction is connecting to PayPal.
Historically, the contents of a PNREF indicated a test or a live transaction:
z For test servers, the first and fourth characters were alpha characters (letters), and the
second and third characters were numeric, for example: V53A17230645.
z For live servers, the first four characters were alpha characters (letters), for example:
VPNE12564395.
However, this is not always the case, and as a rule, you should not place any meaning on the
contents of a PNREF.
AUTHCODE Returned for Sale, Authorisation, and Voice
Authorisation transactions. AUTHCODE is the
approval code obtained over the telephone from
the processing network.
AUTHCODE is required when submitting a
Force (F) transaction.
Alpha-
numeric
6
T
ABLE 4.1 Transaction response values(Continued)
Field Description Type Length