HTML Samples and Buy Now, Donations, and Shopping Cart Variables

A

Prepopulating Your Customer's PayPal Sign Up 

T

ABLE

A.6

Variables for Individual Items in Third Party Shopping Carts

Character 

Name

Description

Length

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 

200

defined for 

os0_

x

to be recognized.

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 

200

defined for os1_x

to be recognized.

4. Repeat for each item included in cart.

N

O T E

:

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

. 

Prepopulating Your Customer's PayPal Sign Up 

If you have already collected your customer's information, you can pass this information to 

PayPal to prepopulate the first page of a new customer's sign up. The fields and parameters 

are listed in the following table. You can pass all or none of this data, as necessary. While your 

customer's sign up page will be prepopulated, it will still be editable. 

To pass this information to the PayPal payment pages, post the variable name and the 

associated data to PayPal in the HTML in the form of 

variable name

 = 

value

. You will also 

136

August, 2005 Website Payments Standard Checkout Integration Guide