User's Manual

HTML Samples
PayPal Shopping Cart HTML and Variables
A
140 May, 2005 Merchant User Manual and Integration Guide
5. Repeat for each item included in cart.
NOTE: Include a set of required variables and any optional variables from the table above for
each item included in your buyer’s cart. The first item included in the cart should be
defined with parameters ending in “_1”, such as “item_name_1”, “amount_1”, and so
forth. Similarly, the second item should be denoted with variables like “item_name_2”,
“amount_2”, etc.
The “_
x” values must increment by 1 in sequence in order to be recognized. If you skip
from item #1 to item #3 without defining an item #2, the third item is ignored
To specify currency: All monetary variables (
amount_x, shipping_x, shipping2_x,
handling_
x, tax_x, and tax_cart) are interpreted in the currency designated by the
currency_code variable posted with the payment. Because currency_code is not item-
specific, there is no need to append _x to the currency_code variable name. If no
currency_code variable is posted, we will assume that all monetary values are in U.S.
Dollars.
To specify cart-wide tax: Use the tax_cart variable to specify a tax amount that applies to
the entire purchase, rather than to individual items. The tax_cart variable overrides any per-
item tax amount specified with tax_
x.
shipping2_x The cost of shipping each additional piece (quantity of 2 or
above) of item #
x.
handling_x The cost of handling for item #
x.
tax_x The tax amount for item #
x.
on0_x First option field name for item #
x 64
os0_x First set of option value(s) for item #
x. on0_x must be
defined for
os0_x to be recognized.
200
on1_x Second option field name for item #
x.64
os1_x Second set of option value(s) for item #
x. on1_x must be
defined for os1_x
to be recognized.
200
T
ABLE A.4 Variables for Individual Items in Third-Party Shopping Carts
Name Description
Character
Length