Welcome to Zuora Product Documentation

Explore our rich library of product information

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

PayPal Wallet

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.

Apple Pay

Zuora supports Apple Pay as a payment method for the PayPal Complete Payments (PPCP) gateway integration. Apple Pay on PayPal Complete Payments supports the following card brands:

  • Visa
  • MasterCard
  • American Express
  • Discover
  • JCB

.Zuora automatically determines whether an Apple Pay payment method uses an MPAN or DPAN during the token decryption process. To support consistent recurring payments and avoid failures when a customer changes devices, include the MPAN-related fields when generating Apple Pay tokens. For more detailed information, see Set up Apple Pay.

You can create Apple Pay payment methods through the following channels:

Note that

  • Store-only is not supported. You cannot create an Apple Pay payment method on the PayPal Complete Payments gateway without also processing a payment.
  • Non-referenced refunds are not supported. Refunds must reference the original Apple Pay payment transaction.
  • 3D Secure authentication is handled natively within the Apple Pay flow (via the cryptogram in the Apple Pay token).

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.