Integration Guide
Table Of Contents
- Preface
- Introduction
- Payment Data Transfer
- Instant Payment Notification (IPN)
- Downloadable History Log
- IPN and PDT Variables
- Data Type, Maximum Field Lengths, and URL Encoding
- About These Tables of Variables
- test_ipn Variable in Sandbox
- IPN Variables in All Posts
- Buyer Information
- Basic Information
- Advanced and Custom Information
- Shopping Cart Information
- Currency and Currency Exchange
- Auctions
- Mass Payment
- Subscriptions Variables
- Dispute Notification Variables
- PDT-Specific Variables
- Downloadable History Log Columns and Values
- Country Codes
IPN and PDT Variables
Shopping Cart Information
44 August 2005
option_
name1
PayPal appends the number of the item where x represents the number of the
shopping cart detail item (e.g.,
option_name1, option_name2).
option_
name2
PayPal appends the number of the item where
x represents the number of the
shopping cart detail item (e.g.,
option_name2, option_name2).
option_
selection1_
x
PayPal appends the number of the item (e.g., option_selection1,
option_selection2), where x represents the number of the shopping cart
detail item.
option_
selection2_
x
PayPal appends the number of the item where x represents the number of the
shopping cart detail item (e.g.,
option_selection1,
option_selection2).
parent_txn_
id
In the case of a refund, reversal, or canceled reversal, this variable contains the
txn_id of the original transaction, while txn_id contains a new ID for the
new transaction.
Character length and limitations: 17
payment_
date
Time/Date stamp generated by PayPal [format: “18:30:30 Jan 1, 2000 PST”]
payment_
status
Canceled-
Reversal
Completed
Denied
Expired
Failed
In-Progress
Partially-
Refunded
Pending
Processed
Refunded
Reversed
Voided
The status of the payment:
Canceled-Reversal: A reversal has been canceled. For example, you won a
dispute with the customer, and the funds for the transaction that was reversed
have been returned to you.
Completed: The payment has been completed, and the funds have been added
successfully to your account balance.
Denied: You denied the payment. This happens only if the payment was
previously pending because of possible reasons described for the
PendingReason element.
Expired: This authorization has expired and cannot be captured.
Failed: The payment has failed. This happens only if the payment was made
from your customer’s bank account.
In-Progress: The transaction is in process of authorization and capture.
Partially-Refunded: The transaction has been partially refunded.
Pending: The payment is pending. See
“pending_ reason” on page 45 for
more information.
Refunded: You refunded the payment.
Reversed: A payment was reversed due to a chargeback or other type of
reversal. The funds have been removed from your account balance and
returned to the buyer. The reason for the reversal is specified in the
ReasonCode element.
Processed: A payment has been accepted.
Voided: This authorization has been voided.
T
ABLE A.3 IPN and PDT Variables: Shopping Cart Information
Variable Name Possible Values Description