Welcome to Zuora Product Documentation

Explore our rich library of product information

Overview of payment gateway integration for Braintree

Zuora provides the following versions of payment gateway integration for Braintree:

  • Braintree
  • Braintree v2.0

Supported payment flows

The following payment flows are supported:

  • Create and save a payment method.
  • Process a one-time payment without saving the payment method.
  • Process the first payment and save the payment method for subsequent recurring payments.

For more information, see the following articles:

  • Implement Payment Pages 2.0 to support one-time payment flows
  • Set up Apple Pay
  • Set up Google Pay with Zuora JavaScript SDK
  • Set up PayPal on Braintree v2.0

Support for 3D Secure 2.0

Both Braintree and Braintree v2.0 gateway integrations provide support for 3DS2. To enable 3DS2, see Enable 3DS2 for Braintree gateway integration and Zuora’s implementation of 3D Secure 2.0 for more information.

After 3DS2 is enabled in the Payment Pages settings, the following features are supported:

  • Enforce the 3DS2 authentication challenge if possible by selecting the 3DS2 Challenge Requested configuration field on the gateway setting page for your ​​Braintree instance. See Configuration fields for more information.

  • Implement a Payment Page to support one-time payment flow. See Implement Payment Pages 2.0 to support one-time payment flows for more information.

The "Best practices" section in Zuora’s implementation of 3D Secure 2.0 also provides best practices for reducing the possibility of failed transactions due to 3DS2 authentication errors.

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 Braintree v2.0 payment gateway integration supports Delayed Capture for all the supported payment methods, which involves the use of the following API operations:

  • Create authorization

  • Create a payment to capture the payment or Cancel authorization

Zuora also supports capturing authorizations that were generated externally by using Zuora's Create authorization API operation.

Support for Level 2 and Level 3 card data processing

The Braintree v2.0 payment gateway integration supports processing Level 2 and Level 3 credit card data. For more information, see the following articles:

  • Level 2 and Level 3 card data support for Braintree v2.0

  • Set up and configure a Braintree v2.0 payment gateway instance

  • Level 2 and Level 3 Card Data

Support for stored credential profiles

Both Braintree and Braintree v2.0 gateway integrations include support for the Stored Credential Transactions framework.

The Braintree gateway integration also supports the sharing NTI feature, while the Braintree v2.0 gateway integration does not support it.

For details, see Support for stored credential transactions overview .

Support for Real-Time Reconciliation

The Braintree v2.0 payment gateway integration supports Real-Time Reconciliation. With this feature enabled, the payment gateway can submit notifications to Zuora for payment and refund event types, and the corresponding records can be automatically updated in real-time. For more information, see the following articles:

  • Real-Time Reconciliation

  • Configure Real-Time Reconciliation

  • Real-Time Reconciliation events for Braintree v2.0

Supported Gateway Options fields

Through both versions of the payment gateway integration for Braintree, you can submit the following additional information to the Braintree gateway by using Gateway Options fields through Payment Pages or the Create a payment REST API operation.

Limitation

No Payment Method Updater service is available for the Braintree or Braintree v2.0 payment gateway integration in Zuora. You can use Braintree's Account Updater service to update the credit card information on the Braintree side. This service operates independently of Zuora. Therefore, you must manually configure the Account Updater service in Braintree instead of in Zuora.

  • Set up and configure a Braintree gateway instance

  • Set up and configure a Braintree v2.0 payment gateway instance

  • Set up payment methods on Braintree v2.0

  • Field mappings for credit card reference transactions through Braintree v2.0

  • Level 2 and Level 3 card data support for Braintree v2.0