Integration Guide
Table Of Contents
- Express Checkout Integration Guide
- Contents
 - Preface
 - 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
 - Implementing Parallel Payments
 - Handling Payment Settlements
 - Handling Recurring Payments
- How Recurring Payments Work
 - Recurring Payments Terms
 - Options for Creating a Recurring Payments Profile
 - Recurring Payments With Express Checkout
 - 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
 
 
Express Checkout Integration Guide May 2010 3
Contents
Preface  . . . . . . . . . . . . .  . . . . . . . . . . . . . . .  . . . . . . 9
Intended Audience . . . . . . . . . . . . . . . . . . .  . . . . . . . . . . . . . . . .  . .  . . 9
Where to Go for More Information . . . . . . . . . . . .  . . . . . . . . . . . . . . . .  . . . 9
Revision History  . . . . . . . .  . . . . . . . . . . .  . . . . . . . . . . . . . . . .  . .  . . . 9
Chapter 1 Introducing Express Checkout . . . . . . . . . . . . . . .11
The Express Checkout Experience . . . . . . . . . .  . . . . . . . . . . . . . . . .  . . . 11
Express Checkout Integration Steps . . . . . . . . . . .  . . . . . . . . . . . . . . . .  . . 12
Configuring and Customizing the Express Checkout Experience . . . . . . . .  . . . . 13
Additional PayPal API Operations . . . . . . . . . . .  . . . . . . . . . . .  . . . . . . 13
Express Checkout Flow . . . . . . . . . . . . . . . .  . . . . . . . . . . . . . . .  . . . .  14
Checkout Entry Point  .  . . . . . . . . . . . . . . . .  . . . . . . . . . . .  . . . . . . 14
Payment Option Entry Point . . . . . . . . . . . . . .  . . . . . . . . . . .  . . . . . . 15
Express Checkout Building Blocks. . . . . . . . . . .  . . . . . . . . . . . . . . . .  . . . 15
Express Checkout Buttons. . . . . . . . . . . . . . .  . . . . . . . . . . .  . . . . . . 16
Express Checkout API Operations  . . . . . . . .  . . . . . . . . . . . . . . . .  . . . 17
Express Checkout Command  . . . . . . . . . . . .  . . . . . . . . . . . . . . . .  . . 17
Express Checkout Token Usage. . . . . . . . . . . .  . . . . . . . . . . .  . . . .  . . 18
Chapter 2 Express Checkout Button and Logo Image Integration . . .19
About PayPal Button and Logo Images  . . . . . . . . .  . . . . . . . . . . . . .  . . . . . 19
Express Checkout Images. . . . . . . . . . . .  . . . . . . . . . . . . . . .  . . . . . 19
Express Checkout Image Flavors . . . . . . . . . .  . . . . . . . . . . . . . . . .  . . 19
Dynamic Images . . . . . . . . . . . . . . . . . . .  . . . . . . . . . . . . . . . .  . . . . 20
Configuring the Dynamic Image  . . . . . . . . . . . .  . . . . . . . . . . . . . . . .  . . . 20
Set Up the Default Image . . . . . . . . . . . . . . .  . . . . . . . . . . . . . . .  . . 21
Set Up Image for Dynamic Use  . . . . . . . . . . . . . . . . . . . . . . . .  . . . . . 21
Change the Locale. . .  . . . . . . . . . . . . . . . .  . . . . . . . . . . .  . . . . . . 22
Feedback to Buyer Meeting an Incentive . .  . . . . . . . . . . . . . . . . .  . . . . . 22
Choose the Image . .  . . . . . . . . . . . . . . . .  . . . . . . . . . . . . . . . .  . . 22
Dynamic Image Command Reference . . . . . . . . . . .  . . . . . . . . . . . . .  . . . . 22
Dynamic Image Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . .  . . . . 23
Locale Codes . . . . . . . . . . . . . . . . . . .  . . . . . . . . . . . . . . .  . . . .  23










