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
Contents
6 October 2009
Chapter 10 Handling Recurring Payments. . . . . . . . . . . . . . . .89
How Recurring Payments Work . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Recurring Payments Terms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Recurring Payments With Express Checkout . . . . . . . . . . . . . . . . . . . . . . . . 91
Initiating the Processing Flow With SetExpressCheckout . . . . . . . . . . . . . . . 93
Redirecting the Buyer’s Browser to PayPal . . . . . . . . . . . . . . . . . . . . . . . 94
Getting Buyer Details Using GetExpressCheckoutDetails. . . . . . . . . . . . . . . . 95
Creating the Profiles With CreateRecurringPaymentsProfile . . . . . . . . . . . . . . 95
Options for Creating a Recurring Payments Profile . . . . . . . . . . . . . . . . . . . . . 95
Specifying the Regular Payment Period . . . . . . . . . . . . . . . . . . . . . . . . . 95
Including an Optional Trial Period . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Specifying an Initial Payment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Maximum Number of Failed Payments . . . . . . . . . . . . . . . . . . . . . . . . . 97
Billing the Outstanding Amount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Recurring Payments Profile Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Getting Recurring Payments Profile Information . . . . . . . . . . . . . . . . . . . . . . . 98
Modifying a Recurring Payments Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Updating Addresses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .100
Updating the Billing Amount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .100
Billing the Outstanding Amount of a Profile . . . . . . . . . . . . . . . . . . . . . . . . .100
Recurring Payments Notifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .101
Chapter 11 Using Other PayPal API Operations . . . . . . . . . . . . 103
Issuing Refunds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103
Handling Payment Review . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .104
Chapter 12 Integrating giropay with Express Checkout . . . . . . . . 107
giropay Page Flows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .107
giropay Payment Page Flow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .107
Cancelled or Unsuccessful giropay Payment Page Flow . . . . . . . . . . . . . . . .108
giropay Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .109
Initiate the Flow with SetExpressCheckout . . . . . . . . . . . . . . . . . . . . . . .109
Redirect the Customer to PayPal . . . . . . . . . . . . . . . . . . . . . . . . . . . .109
Complete the Transaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .110
Receive Transaction Status Notification . . . . . . . . . . . . . . . . . . . . . . . . .110