Welcome to Zuora Product Documentation

Explore our rich library of product information

Best practices for monitoring CPR

Monitor the operations of Configurable Payment Retry (CPR) and the affected invoices to ensure that your payment retry strategies perform as expected.

CPR payment execution

To verify CPR execution, see the Implement CPR section. The Failure tab in your CPR instance shows any processing failures that prevent CPR from continuing to run.

CPR performance

To monitor the performance of your CPR strategies, use the CPR dashboard. Navigate to Administration > System Health > Configurable Payment Retry Dashboard. For more information, see the Configurable Payment Retry dashboard.

Gateway errors and payment attempts

Use the gateway error responses to determine whether to map payment failures differently or to apply tailored logic for frequently received responses. For example:

  • If you see many failures related to expired payment methods, consider using the Payment Method Updater service.

  • If you see many failures because of insufficient funds, change the retry schedule to retry on more favorable days for your subscriber base, or update the communications you send to better align with retry attempts.

Payment attempt analysis

Review the Payment Attempt analysis to evaluate the success of your configured retry attempts. For example, if you retry payments 10 times but never recover the payment on the last or second-to-last attempt, consider removing those retries.

Customer group performance

Review the performance of a customer group to understand how your retry logic affects payment recovery. If you need to make changes, modify the existing group or create a new group to simplify data evaluation.

For example, a customer group with many documents in the Complete-External retry status indicates that something is changing the document between retry attempts, which results in a zero balance and removes the need for further retries. This typically occurs because of one-off payments or document write-offs.