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 41
IPN and PDT Variables
Basic Information
Basic Information
address_
street
Customer’s street address. 200
address_zip Zip code of customer’s address. 20
first_name Customer’s first name 64
last_name Customer’s last name 64
payer_
business_
name
Customer’s company name, if customer represents a business 127
payer_email Customer’s primary email address. Use this email to provide any
credits.
127
payer_id Unique customer ID. 13
payer_
status
verified
unverified
Customer has a Verified PayPal account.
Customer has an Unverified PayPal account.
residence_
country
Two-character ISO 3166 country code 2
T
ABLE A.1 IPN and PDT Variables: Basic Information
Variable Name Possible Values Description
Character
Length
business Email address or account ID of the payment recipient (i.e., the
merchant). Equivalent to receiver_email if payment is sent
to primary account, and essentially an echo of the business
variable passed in the Website Payment button HTML code.
127
item_name Item name as passed by you, the merchant. Or, if not passed by
you, as entered by your customer. If this is a shopping cart
transaction, PayPal will append the number of the item (e.g.,
item_name1, item_name2).
127
item_number Pass-through variable for you to track purchases. It will get
passed back to you at the completion of the payment. If omitted,
no variable will be passed back to you.
127
T
ABLE 4.1 IPN and PDT Variables: Buyer Information
Variable Name Possible Values Description
Character
Length