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:
- 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 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.
Limitation
- 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.