Integration Guide

PayPal Payments Standard Integration Guide June 2012 323
Third-Party Shopping Carts – The Cart Upload Command
Implementing the Cart Upload Command
7
Required Third-Party Shopping Cart Variables
There are two ways to integrate your third-party shopping cart with PayPal and PayPal
Payments Standard:
 Pass the details of the individual items.
 Pass the aggregate amount of the total cart payment rather than the individual item details.
Passing Individual Item Details to PayPal
If you code your third-party shopping cart to pass individual items to PayPal, information
about the items is included in buyers’ and merchants’ transaction histories and notifications.
1. Set the cmd variable to _cart.
2. Include the upload variable:
<input type="hidden" name="upload" value="1">
3. Define item details for each item in the cart.
Specify the required variables and any optional variables listed in Technical HTML Variables.
Append _
x to the variable name, where x is the item number, starting with 1 and increasing by
one for each item added to the cart. The first item in the cart must be defined with variables
ending in _1, like item_name_1, amount_1, and quantity_1; the second item with
variables like item_name_2, amount_2, and quantity_2; the third item with variables like
item_name_3, amount_3, and quantity_3; and so on.
IMPORTANT: Sequentially increment the _x value by 1 to have PayPal recognize each item.
Skipping one or more numbers in the sequence causes PayPal to ignore
items.. For example, if you skip from item #1 to item #3 without defining an
item #2, PayPal ignores the third item.
Name Description
amount_1 Price of a single item or the total price of all items in the
shopping cart
business Email address of your PayPal account
item_name_1 Name of the item or a name for the entire shopping cart
upload Indicates the use of third-party shopping cart