Integration Guide
Table Of Contents
- Website Payments Pro Hosted Solution Integration Guide
- About This Guide
- Intended Audience
- Revision History
- Documentation Feedback
- Getting Started with Website Payments Pro Hosted Solution
- Integrating Your Website Using HTML
- Customising Your PayPal Payment Page
- Integrating iFrame in Your Website
- Integrating Your Website Using API
- Testing Your Integration in Sandbox
- Order Processing
- Protecting Buttons by Using Encrypted Website Payments
- Public Key Encryption Used by Encrypted Website Payments
- Setting Up Certificates Before Using Encrypted Website Payments
- Generating Your Private Key Using OpenSSL
- Generating Your Public Certificate Using OpenSSL
- Uploading Your Public Certificate to Your PayPal Account
- Downloading the PayPal Public Certificate from the PayPal Website
- Removing Your Public Certificate
- Using Encrypted Website Payments to Protect Your Payment Buttons
- Blocking Unprotected and Non-encrypted Website Payments
- Optional API Operations
- Moving from Website Payments Standard to Hosted Solution
- Error Messages
- Currency Codes
- Index
Integrating Your Website Using HTML
Simple Hosted Solution Integration
16
The return URL is appended with a Transaction ID on the query string during the redirect back
from the payment page to your website. This Transaction ID can be used to retrieve the status
and verify the authenticity of the transaction. For detailed information on verifying the
authenticity of the transaction before fulfilling the order, refer to Chapter 7, “Order
Processing.
Sample Integration
Below is an example of a simple Hosted Solution integration:
1. Sample Hosted Solution Form POST:
<form action="https://securepayments.paypal.com/cgi-bin/acquiringweb"
method="post">
<input type="hidden" name="cmd" value="_hosted-payment">
<input type="hidden" name="subtotal" value="50">
<input type="hidden" name="business" value="HNZ3QZMCPBAAA">
<input type="hidden" name="paymentaction" value="sale">
<input type="hidden" name="return"
value="https://yourwebsite.com/receipt_page.html">
<input type="submit" name="METHOD" value="Pay">
</form>
The bold text is the value for the corresponding variable. It is recommended that you
enclose the values in quotes. For detailed information on these values, refer to Table 2.1,
“HTML Variables for Settings of Payment Page.
2. Output the HTML text into your website at the point where buyers will proceed with their
checkout.
3. Open your checkout page and test the button to ensure that it opens the PayPal payment
page.
You can also use the PayPal sandbox environment to test your integration. For complete
information on testing your integration in the PayPal Sandbox environment, refer to
Chapter 6, “Testing Your Integration in Sandbox.