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
IPN and PDT Variables
Currency and Currency Exchange
46 August 2005
Currency and Currency Exchange
tax PayPal appends the number of the item (e.g., item_name1, item_name2).
The tax_
x variable is included only if there was a specific tax amount applied
to a particular shopping cart item. Because profile tax may apply to other
items in the cart, the sum of tax_
x might not total to tax.
txn_id A unique transaction ID generated by the PayPal system.
Character length and limitations: 17
txn_type cart
send_money
web-accept
cart: Transaction created by customer via the PayPal Shopping Cart feature.
send-money: Transaction created by customer from the Send Money tab on
the PayPal website.
web-accept: Transaction created by customer via Buy Now, Donation, or
Auction Smart Logos.
T
ABLE A.4 IPN and PDT Variables: Currency and Currency Exchange Information
Variable Name Possible Values Description
exchange_
rate
Exchange rate used if a currency conversion occurred.
mc_currency See table of
supported
currencies.
For payment IPNs, this is the currency of the payment. For non-payment
subscription IPNs, this is the currency of the subscription.
mc_fee Transaction fee associated with the payment. mc_gross minus mc_fee will
equal the amount deposited into the receiver_email account. Equivalent to
payment_fee for USD payments. 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.
mc_gross Full amount of the customer's payment, before transaction fee is subtracted.
Equivalent to payment_gross for USD payments. 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.
mc_handling
#
This is the total handling amount associated with the transaction.
If this is a shopping cart transaction, see
Table A.3, “IPN and PDT
Variables: Shopping Cart Information” on page 43
for more information.
mc_shipping
#
This is the total shipping amount associated with the transaction.
If this is a shopping cart transaction, see
Table A.3, “IPN and PDT
Variables: Shopping Cart Information” on page 43
for more information.
T
ABLE A.3 IPN and PDT Variables: Shopping Cart Information
Variable Name Possible Values Description