home

Zuora Payments

Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableRelease NotesBasicsEntitlementsSupport and policies
Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableRelease NotesBasicsEntitlementsSupport and policies

Welcome to Zuora Product Documentation

Explore our rich library of product information

Show Contents

thumbnailZuora Payments

Configure Real-Time Reconciliation

Enable and configure Real-Time Reconciliation for Braintree v2.0

Learn how to enable and configure Real-Time Reconciliation for Braintree v2.0 in Zuora, including setting up a Braintree gateway instance, configuring webhooks, and managing reconciliation credentials.

  • A Braintree v2.0 gateway instance has been configured in Zuora.
  • Ensure that the merchant ID has not been configured for any other tenant or entity for Real-Time Reconciliation enablement. Configuring one merchant ID for multiple entities or tenants in the same environment for Real-Time Reconciliation is not supported.

  • In your Braintree merchant console, configure the webhook service by following the instructions in Braintree's documentation.

    When configuring the service URL, use the <Zuora_Data_Center_URL>/payment-reconciliation-webhook/braintree/v1/<merchantId> format, such as https://rest.sandbox.na.zuora.com/payment-reconciliation-webhook/braintree/v1/abc12345def678y. You can know which data center you are in by checking the URL of your environment. For details about Zuora environments, see Zuora Data Centers.

To enable and configure Real-Time Reconciliation for Braintree v2.0, complete the following steps:

  1. Click your username in the upper right and navigate to Settings > Payments > Configure Real-Time Reconciliation.
    This page displays all available Real-Time Reconciliation configuration mappings for active gateway authentication credentials.
  2. Review the following information:
    • Name: the merchant ID of your Braintree merchant account.
    • Gateway Type: the type of the gateway instance associated with the Real-Time Reconciliation service.
    • Gateway Identifier: the merchant ID of your Braintree merchant account.
    • User: the Zuora username of the user who performs the reconciliation actions.
    • Actions: the operations for managing the Real-Time Reconciliation configuration:
      • Delete: Delete a configuration mapping.
      • Edit: Update the Public Key, Private Key, Use Gateway Test Environment settings, and the user who will perform the reconciliation actions.
  3. Select Braintree from the Gateway Type dropdown list, and then click Add.
  4. In the Configuration to reconcile events section on the Enable Real-Time Reconciliation page, enter the following credentials required to validate and process the webhooks from Braintree:
    • Merchant ID
    • Public Key
    • Private Key
    • Use Gateway Test Environment: If the credentials are for the sandbox environment, select this checkbox.
  5. In the User to reconcile events section, add the user that will be used by Zuora to perform the reconciliation actions.

    Select any of the following options. Ensure the user has obtained the required permissions. Note that only users created through the Zuora UI are loaded in the list. Users created through One ID are not available in the list.

    • Current User: the user who is logging in to Zuora and performing this Real-Time Reconciliation enablement.
    • Select a User: Select a user from the list who has obtained the required permissions to perform reconciliation actions.
  6. Click Submit.

Last updated: February 9, 2026