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
Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
About This Guide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Revision History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Documentation Feedback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Chapter 1 Getting Started with Website Payments Pro Hosted Solution 9
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Features and Benefits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
How Hosted Solution Works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Value-Added Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Fraud Management Filters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Recurring Payments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
PayPal Express Checkout Transaction Processing . . . . . . . . . . . . . . . . . . . . . 12
Introduction to Integrating with Hosted Solution . . . . . . . . . . . . . . . . . . . . . . . 13
Chapter 2 Integrating Your Website Using HTML. . . . . . . . . . . .15
Simple Hosted Solution Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Sample Integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
HTML Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Chapter 3 Customising Your PayPal Payment Page . . . . . . . . . .21
Modifying Your PayPal Account Settings . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Customisation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Adding HTML Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Chapter 4 Integrating iFrame in Your Website . . . . . . . . . . . . .33
Integrating iFrame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Manual Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
API Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35