Integration Guide

Table Of Contents
Contents
6 October 2009
Sale Payment Action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Authorization Payment Action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Order Payment Action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Chapter 12 Handling Recurring Payments. . . . . . . . . . . . . . . .97
How Recurring Payments Work . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Recurring Payments Terms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Recurring Payments With Express Checkout . . . . . . . . . . . . . . . . . . . . . . . . 99
Initiating the Processing Flow With SetExpressCheckout . . . . . . . . . . . . . . .101
Redirecting the Buyer’s Browser to PayPal . . . . . . . . . . . . . . . . . . . . . . .102
Getting Buyer Details Using GetExpressCheckoutDetails. . . . . . . . . . . . . . . .103
Creating the Profiles With CreateRecurringPaymentsProfile . . . . . . . . . . . . . .103
Recurring Payments With Direct Payments . . . . . . . . . . . . . . . . . . . . . . . . .103
Options for Creating a Recurring Payments Profile . . . . . . . . . . . . . . . . . . . . .104
Specifying the Regular Payment Period . . . . . . . . . . . . . . . . . . . . . . . . .104
Including an Optional Trial Period . . . . . . . . . . . . . . . . . . . . . . . . . . . .105
Specifying an Initial Payment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106
Maximum Number of Failed Payments . . . . . . . . . . . . . . . . . . . . . . . . .106
Billing the Outstanding Amount . . . . . . . . . . . . . . . . . . . . . . . . . . . . .107
Recurring Payments Profile Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .107
Getting Recurring Payments Profile Information . . . . . . . . . . . . . . . . . . . . . . .107
Modifying a Recurring Payments Profile . . . . . . . . . . . . . . . . . . . . . . . . . . .108
Updating Addresses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .109
Updating the Billing Amount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .109
Billing the Outstanding Amount of a Profile . . . . . . . . . . . . . . . . . . . . . . . . .109
Recurring Payments Notifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .110
Chapter 13 Using Other PayPal API Operations . . . . . . . . . . . . 111
Issuing Refunds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Handling Payment Review . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .112
Chapter 14 Integrating giropay with Express Checkout . . . . . . . . 115
giropay Page Flows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .115
giropay Payment Page Flow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .115
Cancelled or Unsuccessful giropay Payment Page Flow . . . . . . . . . . . . . . . .116
giropay Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117