User's Manual

Merchant User Manual and Integration Guide May, 2005 139
HTML Samples
PayPal Shopping Cart HTML and Variables
A
For more information on the additional variables, please to the HTML and Hyperlink
Variables section of the PayPal Buy Now Buttons HTML Code and Variables section of
Appendix A.
Passing Individual Items to PayPal
If your third-party shopping cart can be configured to pass individual items to PayPal,
information about the items will be included in the buyer’s and seller’s History logs and
notifications. To include information about the items, you will post HTML form elements to a
new version of PayPal’s Shopping Cart flow. This process is much like the one described in
Passing Aggregate Cart Amount to PayPal, with the following exceptions:
1. Set the cmd variable to “_cart”.
2. Replace this required HTML line:
<input type="hidden" name="cmd" value="_xclick">
with
<input type="hidden" name="cmd" value="_cart">
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 included in the
shopping cart.
TABLE A.4 Variables for Individual Items in Third-Party Shopping Carts
Name Description
Character
Length
item_name_
x Required for item #x. Name of item #x in the cart. Must be
alphanumeric.
127
item_number_x Pass-through variable for you to track purchases or
donations. It will get passed back to you at the completion of
the payment. If omitted, no variable will be passed back to
you.
127
amount_x Required for item #
x. Price of the item #x.
quantity_x Required for item #
x. Quantity of the item #x.
shipping_x The cost of shipping the first piece (quantity of 1) of item
#
x.