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
August 2005 45
IPN and PDT Variables
Shopping Cart Information
payment_
type
echeck
instant
echeck: This payment was funded with an eCheck.
instant: This payment was funded with PayPal balance, credit card, or
Instant Transfer.
pending_
reason
address
authorization
echeck
intl
multi-currency
unilateral
upgrade
verify
other
This variable is set only if payment_status = Pending.
address: The payment is pending because your customer did not include a
confirmed shipping address and your Payment Receiving Preferences is set yo
allow you to manually accept or deny each of these payments. To change your
preference, go to the Preferences section of your Profile.
authorization: You set <PaymentAction>
Authorization</PaymentAction> on SetExpressCheckoutRequest
and have not yet captured funds.
echeck: The payment is pending because it was made by an eCheck that has
not yet cleared.
intl: The payment is pending because you hold a non-U.S. account and do
not have a withdrawal mechanism. You must manually accept or deny this
payment from your Account Overview.
multi-currency: You do not have a balance in the currency sent, and you
do not have your Payment Receiving Preferences set to automatically
convert and accept this payment. You must manually accept or deny this
payment.
unilateral: The payment is pending because it was made to an email
address that is not yet registered or confirmed.
upgrade: The payment is pending because it was made via credit card and
you must upgrade your account to Business or Premier status in order to
receive the funds. upgrade can also mean that you have reached the monthly
limit for transactions on your account.
verify: The payment is pending because you are not yet verified. You must
verify your account before you can accept this payment.
other: The payment is pending for a reason other than those listed above. For
more information, contact PayPal Customer Service.
reason_code chargeback
guarantee
buyer-
complain
t
refund
other
This variable is only set if payment_status =Reversed or Refunded.
chargeback: A reversal has occurred on this transaction due to a chargeback
by your customer.
guarantee: A reversal has occurred on this transaction due to your customer
triggering a money-back guarantee.
buyer-complaint: A reversal has occurred on this transaction due to a
complaint about the transaction from your customer.
refund: A reversal has occurred on this transaction because you have given
the customer a refund.
other: A reversal has occurred on this transaction due to a reason not listed
above.
T
ABLE A.3 IPN and PDT Variables: Shopping Cart Information
Variable Name Possible Values Description