Integration Guide

17
Integrating Your Website Using HTML
HTML Variables
HTML Variables
The table below lists the Hosted Solution HTML variables you can use to send in additional
transaction information along with your web request. For a list of HTML variables that you
can use to customise the look and feel of your payment page, refer to Table 3.1, “HTML
Variables for Look and Feel of Payment Page.
N OTE: The values you pass must not contain any of these special characters (){}<>\";
N OTE: Some merchants are required to pass billing information with every transaction. It is
recommended that you test your integration first, particularly if you plan to use iFrame,
to determine if the billing information fields are required.
TABLE 2.1 HTML Variables for Settings of Payment Page
V a r i a b l e D e s c r i p t i o n R e q u i r e d
address1
Street name of shipping address. (1 of 2 fields). No
address2
Street name of shipping address. (2 of 2 fields). No
address_override
The payer is shown the passed-in address but cannot edit
it. This variable is overridden if there are errors in the
address. The allowable values are true/false. Default is
false.
No
billing_address1
Street name of the billing address. (1 of 2 fields). Conditional
billing_address2
Street name of the billing address. (2 of 2 fields). No
billing_city
City name of the billing address. Conditional
billing_country
Country code of the billing address. Conditional
billing_first_name
First name of person the item is being billed to. Conditional
billing_last_name
Last name of person the item is being billed to. Conditional
billing_state
State name of the billing address. Conditional
billing_zip
Zip code of the billing address. Conditional
bn
Identifies the source that built the code for the button.
Format -
<Company>_<Service>_<Product>_<Country>
No
business
Your PayPal account email address or your PayPal ID
(Secure Merchant ID) associated with your PayPal
account. It is recommended that you use your PayPal ID,
which can be found on the top section of the Profile page
on PayPal.com
Yes
buyer_email
Email address of the buyer. No