User Guide

IPN Guide June, 2009 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.
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:
z 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
address_city City of customer’s address
Length: 40 characters
address_country_code ISO 3166 country code associated with customer’s address
Length: 2 characters
address_name Name used with address (included when the customer provides a Gift
Address)
Length: 128 characters
address_state State of customer’s address
Length: 40 characters
Variable Name Description