User's Manual

Adding PayPal to Your Third-party Shopping Cart
Passing the Aggregate Shopping Cart Amount to PayPal
7
72 May, 2005 Merchant User Manual and Integration Guide
3. Add a new variable called upload by adding the following line between the <form> and
</form> tags:
<input type="hidden" name="upload" value="1">
4. Define item details.
For each of the following item-specific parameters, define a new set of values that
correspond to each item that was purchased via your third-party cart. Append _
x to the
variable name, where
x is the item number, starting with 1 and increasing by one for each
item that is added.
5. Repeat for each item included in cart.
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 on. Similarly, the
second item should be denoted with variables like item_name_2, amount_2, and so on.
IMPORTANT:The _x values must increment by one continuously in order to be recognized.
If you skip from item #1 to item #3 without defining an item #2, the third item
will be 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.
For a complete list of variables, see the Passing Individual Items to PayPal section of
Appendix A in this manual.