Integration Guide
Table Of Contents
- Website Payments Pro Integration Guide
- Contents
- Preface
- Introducing Website Payments Pro
- Introducing Direct Payment
- Introducing Express Checkout
- Express Checkout Button and Logo Image Integration
- PayPal Name-Value Pair API Basics
- Implementing the Simplest Express Checkout Integration
- Testing an Express Checkout Integration
- Customizing Express Checkout
- Implementing the Instant Update API
- Immediate Payment
- Handling Payment Settlements
- Handling Recurring Payments
- How Recurring Payments Work
- Recurring Payments Terms
- Recurring Payments With Express Checkout
- Recurring Payments With Direct Payments
- Options for Creating a Recurring Payments Profile
- Recurring Payments Profile Status
- Getting Recurring Payments Profile Information
- Modifying a Recurring Payments Profile
- Billing the Outstanding Amount of a Profile
- Recurring Payments Notifications
- Using Other PayPal API Operations
- Integrating giropay with Express Checkout
Contents
4 October 2009
Set Up the Default Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Set Up Image for Dynamic Use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Change the Locale. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Feedback to Buyer Meeting an Incentive . . . . . . . . . . . . . . . . . . . . . . . . 28
Choose the Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Dynamic Image Command Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Dynamic Image Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Locale Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Static PayPal Buttons and Images Source Requirements . . . . . . . . . . . . . . . . . . 31
Chapter 5 PayPal Name-Value Pair API Basics . . . . . . . . . . . . .33
PayPal API Client-Server Architecture. . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
PayPal Name-Value Pair API Requests and Responses . . . . . . . . . . . . . . . . 33
Multiple API Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Obtaining API Credentials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Creating an API Signature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Creating an API Certificate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Creating an NVP Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Specifying the PayPal API Operation . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Specifying an API Credential . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
URL Encoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
List Syntax for Name-Value Pairs . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Executing NVP API Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Specifying a PayPal Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Logging API Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Responding to an NVP Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Common Response Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
URL Decoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Chapter 6 Implementing the Simplest Express Checkout Integration .43
Setting Up the Express Checkout Transaction. . . . . . . . . . . . . . . . . . . . . . . . 43
Obtaining Express Checkout Transaction Details . . . . . . . . . . . . . . . . . . . . . . 45
Completing the Express Checkout Transaction . . . . . . . . . . . . . . . . . . . . . . . 45
Chapter 7 Testing an Express Checkout Integration . . . . . . . . . .47
Chapter 8 Customizing Express Checkout . . . . . . . . . . . . . . .53