home

Zuora Payments

Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableRelease NotesBasicsEntitlementsSupport and policies
Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableRelease NotesBasicsEntitlementsSupport and policies

Welcome to Zuora Product Documentation

Explore our rich library of product information

Show Contents

thumbnailZuora Payments

Set up payment gateway integrations

PayPal Complete Payments gateway integration

Learn about integrating PayPal Complete Payments with Zuora, including supported payment methods, features like Delayed Capture and Real-Time Reconciliation, and limitations.

PayPal has introduced a unified platform called PayPal Complete Payments to replace its multitude of partner integration platforms including Adaptive Payments, Payflow Pro, and Express Checkout. Zuora partners with PayPal Complete Payments to provide a gateway integration called PayPal Complete Payments. This gateway integration offers a consolidated integration with PayPal.

Supported payment methods

You can create PayPal Wallet payment methods through any of the following approaches:

  • Payment Form Add a PayPal button to the hosted payment form. For implementation instructions, see Payment Form .

  • JavaScript SDK integration Add a PayPal button to your checkout flow and process payments by integrating with a JavaScript SDK provided by Zuora. The following payment flows are supported: For implementation instructions, see Set up PayPal on PayPal Complete Payments with Zuora JavaScript SDK.

    • Create and save a payment method.

    • Process a one-time payment without saving the payment method.

  • REST API or UI Create a PayPal payment method through the REST API operation or Zuora UI. For more information, see Define and set up payment methods . You need to implement your own UI and payment processing integration.

Support for Delayed Capture

The Delayed Capture feature allows you to authorize the availability of funds for a transaction but delay the capture of funds until a later time. The PayPal Complete Payments integration supports Delayed Capture for PayPal payment methods. For how to use the Delayed Capture feature, see Payment Authorization in Zuora API Reference.

Support for Real-Time Reconciliation

With this feature enabled, the payment gateway submits notifications to Zuora, and the corresponding records are automatically updated in real time. For more information, see the following articles:

  • Real-Time Reconciliation events for PayPal Complete Payments

  • Configure Real-Time Reconciliation

  • Real-Time Reconciliation

Limitations

  • Only Billing Agreement IDs (BAIDs) generated through PayPal's REST APIs are compatible with Zuora's PayPal Complete Payments integration.

  • Migration of existing payment methods on the following PayPal integrations to the PayPal Complete Payments integration is not supported:

    • PayPal Express Checkout Gateway

    • PayPal Payflow Payment Gateway

    • PayPal Payflow Pro, Website Payments Payflow Edition, Website Pro Payment Gateway

    • PayPal Adaptive Payments Gateway

  • Currently, Zuora will not display Venmo and PayPal Credit payment methods at the same time.

Last updated: October 10, 2025