Welcome to Zuora Product Documentation

Explore our rich library of product information

Sample preapproved payment flow

This task outlines the process of creating and storing a PayPal payment method in Zuora using a preapproval key, enabling recurring payments without requiring the customer to log into PayPal again.

Here is a sample workflow for how a PayPal payment method gets created and stored in Zuora after obtaining the preapproval key:

  1. Customer signs up on your (the merchant’s) website and subscribes to your services.
  2. Customer completes their purchase by selecting a payment method that they wish to use. They select PayPal. (This is the only payment method supported for PayPal Adaptive Payments.)
  3. You initiate a preapproval request with PayPal. PayPal returns a preapproval key that is used when you redirect the end customer's browser to PayPal's site to complete the pre-approval agreement. The pre-approval agreement allows you to charge their PayPal account for recurring payments. On the pre-approval form, the customer will indicate: Once the pre-approval agreement is completed, you will redirect the customer back to your website to continue their check out.
    • The duration of time in which they approve payments to be charged to their PayPal account (specifying a start and end date).

    • The payment amount that can be deducted.

    • The number of times payment can be deducted.

  4. You will call the Zuora API to create a PayPal payment method using the preapproval key from PayPal, then store the payment method in the customer account.
  5. The PayPal payment method can be used to process payments for the current order and future orders. You can submit a payment through Zuora to charge the customer’s PayPal account for the initial payment on that customer's subscription.
  6. Next month (or on the next billing day), you can charge the customer for their next recurring subscription fee using the stored payment method and pre-approval key in their Zuora customer account, without the customer having to log into PayPal again.

Review the PayPal Adaptive Payments Developer Guide (see Preapproved Payments Flow on page 23) to learn more about pre-approved payments and how to set up the workflow for pre-approved payment with your e-Commerce website.