Prerequisites

• Work with Braintree to correctly set up Level 2 and Level 3 requests in your Braintree merchant account.

• In Zuora, configure the CommodityCode and ProductCode custom fields on the Product Rate Plan Charge object. When configuring a Braintree v2.0 gateway instance, the API names (without " __c ") of these custom fields are required. For more information about custom fields, see Custom object definitions.

Visa Commercial Enhanced Data Program (CEDP) behavior

For Visa transactions processed through the Braintree v2 gateway, Zuora applies Visa Commercial Enhanced Data Program (CEDP) rules to Level 2 and Level 3 data. When Level 2/Level 3 data processing is enabled in the Braintree v2 gateway configuration and the enhanced L3 processing feature is enabled for your tenant:

• Zuora applies Visa CEDP formulas to item, tax, discount, partial or negative line items, and rounding calculations before mapping fields to the Braintree GraphQL APIs.
• Zuora dynamically sends only the required Level 2/Level 3 fields for each supported card network (for example, Visa, Mastercard, American Express) to ensure that unnecessary fields are not submitted.
• Zuora normalizes shipping in the enhanced path by sending a zero shipping amount and zero shipping tax amount, and includes per-line item Level 3 details so that item- and transaction-level totals remain consistent with Visa CEDP requirements.

  This behavior is designed to help eligible transactions qualify for Visa CEDP interchange benefits while maintaining consistent, predictable Level 2/Level 3 processing across Braintree v2.

Related information

• Overview of payment gateway integration for Braintree

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