Skip to main content

Overview of Braintree gateway integration


Overview of Braintree gateway integration

Supported features

The following table provides a quick reference for the supported features. For details about each feature, see the later sections in this article.

Supported payment methods Credit Card/Gift Card/Prepaid Card
Support 3D Secure 2.0 Yes
Support Delayed Capture No
Support Level 2 and Level 3 card data No
Support stored credential transactions Yes
Support Gateway Options fields No
Gateway provider’s API version version 2.81.0, Braintree Java JAR
Braintree production endpoints used for Zuora gateway integration service

Support Gateway Reconciliation No
Support Payment Method Updater No
Support one-time payment flow through Payment Pages 2.0 Yes

Supported payment methods

The Braintree gateway integration supports Credit Card/Gift Card/Prepaid Card, including:

  • Visa
  • MasterCard
  • Discover
  • American Express
  • JCB
  • Diners Club

Support for 3D Secure 2.0

Zuora's Braintree gateway integration provides support for 3DS2 through the embedded iFrame of Payment Pages 2.0. 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:

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 stored credential profiles

Braintree gateway includes support for the Stored Credential Transactions framework. For details about the supported payment methods, see Support for stored credential transactions overview.


  • Braintree gateway integration does not support non-referenced refunds.
  • No Payment Method Updater service is available for Braintree 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 the Zuora Billing system. Therefore, you must manually configure the Account Updater service in Braintree instead of in Zuora.