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 Enable batch 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.