Welcome to Zuora Product Documentation

Explore our rich library of product information

Troubleshoot issues that Real-Time Reconciliation events are not handled correctly

Learn how to troubleshoot issues with Real-Time Reconciliation events by ensuring proper configuration, checking user status, and using batch Gateway Reconciliation.

If you find that the Real-Time Reconciliation events are not handled correctly, perform the following steps to troubleshoot:

  1. Ensure that you have configured Real-Time Reconciliation properly according to the prerequisites and instructions in Configure Real-Time Reconciliation .
  2. Ensure that the Zuora user used for reconciling transactions is in Active status. To check the status of a user, click your username in the upper right and navigate to Settings > Administration > Manage Users .
  3. Use the batch Gateway Reconciliation feature to reconcile the failed transactions:
    1. Enable batch Gateway Reconciliation by following the instructions in Configure Gateway Reconciliation .
    2. Use the Payment Gateway Reconciliation REST API operations to reconcile payments and refunds, or wait for Zuora to retrieve the appropriate gateway reconciliation report for processing in a job, usually on a daily basis.
  4. After the failed transactions are reconciled, you can disable batch Gateway Reconciliation and switch back to Real-Time Reconciliation.