Welcome to Zuora Product Documentation

Explore our rich library of product information

Payment attempts and Retry rules

Learn how Configurable Payment Retry (CPR) applies changes to retry rules and how those changes affect future payment retry attempts.

Configurable Payment Retry (CPR) schedules the next retry attempt at the time of payment failure. For example, CPR schedules attempt three after retry attempt two runs. At the time of payment retry execution, CPR uses the configured logic to schedule the next attempt.

Changes to the retry rules apply to future payment attempts and take effect after the currently scheduled attempt runs. The scheduled attempt is the next immediate retry attempt. These changes apply to both the basic retry rule logic and Smart Retry. Changes to retry logic do not restart a retry cycle for previously concluded cycles.

Consider the following scenarios.

Example 1: Basic retry rule

  • You configure a retry rule with a 24-hour window and three retry attempts.

  • You modify the retry rule to add two more attempts.

After the third retry attempt runs, CPR schedules the fourth attempt 24 hours later and the fifth attempt 24 hours after that.

Example 2: Smart Retry rule

  • You configure the Smart Retry rule with a 10-day retry window and five retry attempts.

  • You update the Smart Retry logic to six retry attempts.

CPR runs the additional attempt within the 10-day window and does not exceed the retry window length. If CPR cannot run all retry attempts within the retry window because of configuration changes, the retry cycle ends with a failure status.