2012
Table Of Contents
- Instant Payment Notification Guide
- Contents
- Preface
- Introducing IPN
- Implementing an IPN Listener
- Identifying Your IPN Listener to PayPal
- IPN Testing
- IPN Operations on PayPal
- Using Fraud Management Filters With IPN
- IPN Variable Reference
- IPN Transaction Types
- Transaction and Notification-Related Variables
- Buyer Information Variables
- Payment Information Variables
- Auction Variables
- Mass Pay Variables
- Recurring Payments Variables
- Subscription Variables
- Dispute Resolution Variables
- Pay Message Variables
- Preapproval Message Variables
- Adaptive Accounts IPN Messages
- Payment Review Using Notifications
- Revision History
IPN Guide July 10, 2012 43
IPN Variable Reference
Buyer Information Variables
Buyer Information Variables
Buyer information identifies the buyer or initiator of a transaction by payer ID or email
address. Additional contact or shipping information may be provided.
ipn_track_id Internal; only for use by MTS and DTS
notify_version Message’s version number
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.
Length: 19 characters
receipt_id Unique ID generated during guest checkout (payment by credit card
without logging in).
receiver_email Primary email address of the payment recipient (that is, the merchant). If
the payment is sent to a non-primary email address on your PayPal
account, the receiver_email is still your primary email.
NOTE: The value of this variable is normalized to lowercase characters.
Length: 127 characters
receiver_id Unique account ID of the payment recipient (i.e., the merchant). This is
the same as the recipient's referral ID.
Length: 13 characters
resend Whether this IPN message was resent (equals true); otherwise, this is the
original message.
residence_country ISO 3166 country code associated with the country of residence
Length: 2 characters
test_ipn Whether the message is a test message. It is one of the following values:
1 – the message is directed to the Sandbox
txn_id The merchant’s original transaction identification number for the payment
from the buyer, against which the case was registered.
txn_type The kind of transaction for which the IPN message was sent.
verify_sign Encrypted string used to validate the authenticity of the transaction
Variable Name Description
address_country Country of customer’s address
Length: 64 characters
Variable Name Description