Integration Guide

Handling Recurring Payments
Recurring Payments With the Express Checkout API
4
40 January 2012 Digital Goods Integration Guide - EC Edition
Recurring payments processing flow
Step Merchant... PayPal...
1 Adds JavaScript to your webpage to create the
PayPal digital goods payments flow, which appears
in a lightbox overlaying your webpage (Digital
Goods only).
2 Places the Pay With PayPal button on your
webpage.
3Calls SetExpressCheckout, setting up one or
more billing agreements in the request.
4 Returns a token that identifies the transaction to the
merchant.
5 Redirects buyer’s browser to:
https://www.paypal.com/cgi-
bin/webscr?cmd=_express-checkout
&token=
<token returned by
SetExpressCheckout
>
Displays login page and allows user to select
payment options and shipping address.
6 Redirects buyer’s browser to returnURL passed to
SetExpressCheckout if buyer agrees to payment
description.
7Calls GetExpressCheckoutDetails to get
buyer information (optional).
Returns GetExpressCheckoutDetails
response.
Displays merchant review page for buyer.
8Calls DoExpressCheckoutPayment if the order
includes one-time purchases as well as a recurring
payment. Otherwise, skip this step.
Returns DoExpressCheckoutPayment response.
9Calls CreateRecurringPaymentsProfile one
time for each recurring payment item included in
the order. If the order includes a one-time digital
goods purchase, sets values for the required
payment details item parameters. Sets the item
category to Digital.
Returns ProfileID in
CreateRecurringPaymentsProfile response
for each profile successfully created.