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 Stripe v2

Learn how to enable and configure Real-Time Reconciliation for Stripe v2 in Zuora, including setting up OAuth tokens and managing gateway authentication.

  • A Stripe v2 gateway instance has been configured in Zuora. See Stripe payment gateway for instructions about how to create an instance of the gateway.

  • At least one OAuth token for Stripe v2 has been created and activated through the Gateway Authentication payment setting for the intended gateway instance. When creating an OAuth token, if Use Gateway Test Environment is selected, this token can only be used to enable Real-Time Reconciliation in the sandbox environment. Conversely, if Use Gateway Test Environment is not selected, the token can only be used to enable Real-Time Reconciliation in the production environment.

  • Ensure that the merchant account ID has not been configured for any tenant for Real-Time Reconciliation enablement. If an account ID is configured for multiple tenants with Real-Time Reconciliation enabled, only one tenant can receive the Real-Time Reconciliation events.

To enable and configure Real-Time Reconciliation for Stripe v2, 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 tokens.

    • Name : the name of the OAuth token for gateway authentication.

    • Gateway Type : the type of the gateway instance associated with the OAuth token.

    • Gateway Identifier : the ID of the Stripe account associated with the OAuth token.

    • 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 user who will perform the reconciliation actions.

  2. From the Gateway Type dropdown list, select Stripe , and then click Add .
  3. On the Enable Real-Time Reconciliation page, from the Gateway Merchant Account dropdown list, select the authentication token that you have created through the Gateway Authentication payment setting.
  4. In the User to reconcile events section, select any of the following options to define the user who will be used by Zuora to perform the reconciliation actions. 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.

  5. Click Submit .

For dispute events, by default, external refunds are automatically generated for dispute events. If you want to opt out of this default behavior and disable the generation of external refunds for dispute events, submit a request at Zuora Global Support .

Last updated: October 17, 2025