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
- Handling Payment Settlements
- Handling Recurring Payments
- How Recurring Payments Work
- Recurring Payments Terms
- Recurring Payments With Express Checkout
- 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
October 2009 5
Contents
PayPal Page Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Custom Page Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Individual Page Style Characteristics . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Changing the Locale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Handling Shipping Addresses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Confirmed Address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Suppressing the Buyer’s Shipping Address . . . . . . . . . . . . . . . . . . . . . . . 61
Shipping Address Override . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Automatically Filling Out the PayPal Login Page . . . . . . . . . . . . . . . . . . . . . . 65
User Confirms Order on PayPal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Chapter 7 Implementing the Instant Update API . . . . . . . . . . . .69
About the Instant Update API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Integration Steps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Post-Integration Checkout Experience . . . . . . . . . . . . . . . . . . . . . . . . . 70
How the Callback Works in the Express Checkout Flow. . . . . . . . . . . . . . . . . . . 72
Following Instant Update API Best Practices . . . . . . . . . . . . . . . . . . . . . . . . 73
Setting Up the Callback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
GetExpressCheckoutDetails and DoExpressCheckoutPayment Changes . . . . . . . 75
Other Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Using the Callback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
SetExpressCheckout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Callback Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Callback Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Chapter 8 Immediate Payment . . . . . . . . . . . . . . . . . . . . .81
Overview of Immediate Payment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
How Immediate Payment Works in the Express Checkout Flow . . . . . . . . . . . . 81
Integrating Immediate Payment into the Express Checkout Flow . . . . . . . . . . . . . . 83
The Call to SetExpressCheckout . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
The Call to DoExpressCheckoutPayment . . . . . . . . . . . . . . . . . . . . . . . . 84
Chapter 9 Handling Payment Settlements . . . . . . . . . . . . . . .85
Sale Payment Action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Authorization Payment Action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Order Payment Action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86