Advanced Features Guide

Express Checkout Advanced Features Guide April 2012 49
Handling Recurring Payments
Recurring Payments With the Express Checkout API
3
Initiating the Processing Flow With SetExpressCheckout
As in the Express Checkout flow, the SetExpressCheckout request notifies PayPal that you
are:
 Initiating an order that can be either a one-time purchase, up to 10 recurring payments, or a
mixture of a one-time purchase and recurring payments
 Initiating the processing flow to create one or more billing agreements for recurring
payments with no associated one-time purchase or recurring payment
NOTE: You can also initiate the processing flow using SetCustomerBillingAgreement
for orders that contain only a single recurring payment.
Typically, you set the amount of the payment for an Express Checkout transaction when you
call the SetExpressCheckout request. You confirm the amount in the
3 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 buyer 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.
Step Merchant... PayPal...