Integration Guide

Third-Party Shopping Carts – The Cart Upload Command
Implementing the Cart Upload Command
7
324 June 2012 PayPal Payments Standard Integration Guide
The minimum required HTML for your post to PayPal looks similar to the following.
HTML for Passing Individual Item Detail to PayPal
<form action="https://www.paypal.com/cgi-bin/webscr" method="post">
<input type="hidden" name="cmd" value="_cart">
<input type="hidden" name="upload" value="1">
<input type="hidden" name="business" value="[e-mail]">
<input type="hidden" name="item_name_1" value="Item Name 1">
<input type="hidden" name="amount_1" value="1.00">
<input type="hidden" name="shipping_1" value="1.75">
<input type="hidden" name="item_name_2" value="Item Name 2">
<input type="hidden" name="amount_2" value="2.00">
<input type="hidden" name="shipping_2" value="2.50">
<input type="submit" value="PayPal">
</form>
Setting Currency in the Cart
PayPal interprets all monetary variables (amount_x, shipping_x, shipping2_x,
handling_
x, tax_x, and tax_cart) 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 you do not post a
currency_code variable, all monetary values default to U.S. Dollars.
Setting Tax on Individual Items
Use the tax_x variable to specify the tax for a particular item in the cart. For example, the
following line specifies that the tax on item 2 in the cart is 15 cents:
<INPUT TYPE="hidden" name="tax_2" value=".15">
Setting Profile-Based Shipping Charges by Weight on Individual Items
Use the weight_x and weight_unit variables to specify item weights if the merchant uses
weight-based shipping rates. For example, the following lines specify the weight of item 3 in
the cart as 1.5 kg.
<INPUT TYPE="hidden" name="weight_3" value="1.5">
<INPUT TYPE="hidden" name="weight_unit" value="kgs">
Use the quantity_x variable if the merchant uses quantity-based shipping rates. For
example, the following line specifies that the quantity for item 3 in the cart is 6.
<INPUT TYPE="hidden" name="quantity_3" value="6">
For information on how merchants set up wieght-based shipping rates, see the “Automatic
Calculation of Shipping Charges (U.S. Merchants Only)” on page 368.