User's Manual

Merchant User Manual and Integration Guide May, 2005 133
HTML Samples
PayPal Buy Now and Donation Buttons HTML and Variables
A
TABLE A.1 HTML and Hyperlink Variables for Buy Now and Donations Buttons
Name Description
Character
Length
Item Information
amount The price or amount of the purchase, not including shipping, handling, or tax.
If omitted, this value will be editable by the customer at the time of purchase.
item_name Description of item. If omitted, customer will see a field in which they have
the option of entering an item name.
127
item_number 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
on0 First option field name. If omitted, no variable will be passed back to you. 64
quantity Number of items. The amount, shipping and tax will be multiplied by the
quantity to get the total payment amount. If this is a shopping cart transaction,
we will append the number of the item (e.g.
quantity1, quantity2).
undefined_
quantity
If included and set to “1”, enables buyer to modify the quantity.
on1 Second option field name. If omitted, no variable will be passed back to you. 64
os0 First set of option value(s). If this option is selected through a text box or radio
button, each value should be no more than 64 characters. If this value is
entered by the customer through a text box, there is a 200-character limit. If
omitted, no variable will be passed back to you.
on0 must be defined for os0
to be recognized.
64/200 (see
description)
os1 Second set of option value(s). If this option is selected through a text box or
radio button, each value should be no more than 64 characters. If this value is
entered by the customer through a text box, there is a 200-character limit. If
omitted, no variable will be passed back to you.
on1 must be defined for os1
to be recognized.
64/200 (see
description)
Display Information
cn Label that will appear above the note field. This value is not saved and will not
appear in any of your notifications. If omitted, no variable will be passed back
to you.
40
cs Sets the background color of your payment pages. If set to “1,” the background
color will be black. If omitted or set to “0,” the background color will be white.
image_url The internet URL of the 150x50-pixel image you would like to use as your
logo. If omitted, the customer will see your Business name if you have a
Business account, or your email address if you have premier account.