Integration Guide

2
Integrating Your Website Using
HTML
This chapter provides instructions for a simple integration that enables you to begin processing
transactions using Hosted Solution.
N OTE: PayPal recommends that you implement the simple integration to familiarise yourself
with Hosted Solution before implementing a more customised integration.
As part of a simple integration, you get the default settings on your payment page. To
customise the look and feel of the page so it matches your website, you can do one of the
following:
 Change your settings in your Profile section on PayPal.com, as described in “Modifying
Your PayPal Account Settings” on page 21.
 Add the appropriate HTML variables to the payment page, as described in Table 2.1,
“HTML Variables for Settings of Payment Page and Table 3.1, “HTML Variables for Look
and Feel of Payment Page.
IMPORTANT: HTML variables will override the settings you save on your profile page.
Simple Hosted Solution Integration
To integrate your website with Hosted Solution, identify a point in your website checkout flow
where you want to place a button that the buyer clicks to initiate the payment. The button
should be labeled Continue to Payment, Pay or similar, and when clicked, should execute a
Form POST to PayPal. Clicking on this button redirects the buyer’s browser to the PayPal
payment page where they can pay with debit or credit card, or their PayPal account.
The Form POST contains a set of HTML variables that describe the transaction and associate
it with your Website Payments Pro account. In the Form POST, you must specify the
following:
 subtotal - amount of the transaction
 business - Secure Merchant ID (found on the profile page) or the email address
associated with your PayPal account.
 paymentaction - Indicates whether the transaction is for payment on a final sale or an
authorisation for a final sale (to be captured later).
The default currency is USD. Additionally, you can specify the appropriate HTML variables
listed in Table 2.1, “HTML Variables for Settings of Payment Page to customise the
information collected on the payment page or Table 3.1, “HTML Variables for Look and Feel
of Payment Page to customise the look and feel of the page. If the payment is successful, then
the buyer either sees the PayPal confirmation page or is redirected to the URL you specify in
your configuration.