User Guide

Button Manager NVP API April 2012 59
HTML Variables for PayPal Payments Standard
HTML Variables for Shopping Carts
A
HTML Variables for Payment Transactions
HTML Variables for Shopping Carts
HTML variables for shopping carts can be used with Add to Cart buttons, as well as with
third-party shopping carts or custom carts that initiate payment processing with the Cart
Upload command.
Name
Required
or
Optional Description
Character
Length
address_
override
Optional 1 – The address specified with automatic fill-in variables
overrides the PayPal member’s stored address. Buyers see
the addresses that you pass in, but they cannot edit them.
PayPal does not show addresses if they are invalid or
omitted.
1
currency_code Optional The currency of the payment. The default is USD. 3
custom Optional Pass-through variable for your own tracking purposes, which
buyers do not see.
Default – No variable is passed back to you.
256
handling Optional Handling charges. This variable is not quantity-specific. The
same handling cost applies, regardless of the number of
items on the order.
Default – No handling charges are included.
invoice Optional Pass-through variable you can use to identify your invoice
number for this purchase.
Default – No variable is passed back to you.
127
tax_cart Optional Cart-wide tax, overriding any individual item tax_
x value
weight_cart Optional If profile-based shipping rates are configured with a basis of
weight, PayPal uses this value to calculate the shipping
charges for the payment. This value overrides the weight
values of individual items.
Allowable values are decimals numbers, with 2 significant
digits to the right of the decimal point.
weight_unit Optional The unit of measure if weight_cart is specified.
Allowable values are:
 lbs
 kgs
The default value is lbs.