Integration Guide

Express Checkout Integration Guide May 2010 119
Handling Recurring Payments
Recurring Payments With Express Checkout
11
Recurring payments processing flow
Initiating the Processing Flow With SetExpressCheckout
As in the Express Checkout flow, the SetExpressCheckout request notifies PayPal that you
are:
z Initiating an order that can be either a one-time purchase, up to ten recurring payments, or a
mixture of a one-time purchase and recurring payments
Step Merchant... PayPal...
1Calls SetExpressCheckout with one or more
billing agreement details in the request
2 Returns a token, which identifies the transaction, to
the merchant.
3 Redirects buyer’s browser to:
https://www.paypal.com/cgi-
bin/webscr?cmd=_express-checkout
&token=
<token returned by
SetExpressCheckout
>
Displays login page.
Allows user to select payment options and shipping
address.
4 Redirects buyer’s browser to returnURL passed to
SetExpressCheckout if buyer agrees to payment
description.
5Calls GetExpressCheckoutDetails to get
buyer information (optional).
Returns GetExpressCheckoutDetails
response.
Displays merchant review page for buyer.
6Calls DoExpressCheckoutPayment if the order
includes one-time purchases as well as a recurring
payment. Otherwise, skip this step.
Returns DoExpressCheckoutPayment response
Calls CreateRecurringPaymentsProfile one
time for each recurring payment item included in
the order.
Returns ProfileID in
CreateRecurringPaymentsProfile response
for each profile successfully created.
7 Displays successful transaction page.