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 47
IPN and PDT Variables
Auctions
Auctions
payment_fee Transaction-
specific for
USD payments
only
USD transaction fee associated with the payment. payment_gross
minus
payment_fee
equals the amount deposited into the receiver email account.
Is empty for non-USD payments. This is a legacy field replaced by mc_fee. If
this amount is negative, it signifies a refund or reversal, and either of those
payment statuses can be for the full or partial amount of the original
transaction fee.
payment_
gross
Transaction-
specific for
USD payments
only
Full USD amount of the customer’s payment, before transaction fee is
subtracted. Will be empty for non-USD payments. This is a legacy field
replaced by mc_gross. If this amount is negative, it signifies a refund or
reversal, and either of those payment statuses can be for the full or partial
amount of the original transaction.
settle_
amount
Amount that is deposited into the account’s primary balance after a currency
conversion from automatic conversion (through your Payment Receiving
Preferences) or manual conversion (through manually accepting a payment).
settle_
currency
Currency of settle_amount.
T
ABLE A.5 IPN and PDT Variables: Auctions
Variable Name Possible Values Description
Character
Length
auction_
buyer_id
This is the customer’s auction ID. 64
auction_
closing_
date
This is the auction’s close date.
auction_
multi_item
This is the number of items purchased in multi-item auction
payments. It allows you to count the mc_gross
or
payment_gross
for the first IPN you receive from a multi-
item auction (auction_multi_item), since each item from the
auction will generate an Instant Payment Notification showing
the amount for the entire auction.
for_auction true This is an auction payment—payments made using Pay for eBay
Items or Smart Logos—as well as Send Money/Money Request
payments with the type eBay items or Auction Goods (non-
eBay).
T
ABLE A.4 IPN and PDT Variables: Currency and Currency Exchange Information
Variable Name Possible Values Description