Welcome to Zuora Product Documentation

Explore our rich library of product information

Enable Smart Retry

Learn how to enable Smart Retry, a feature that uses machine learning to optimize payment retry strategies by analyzing transaction characteristics and applying them to a training dataset.

Smart Retry utilizes machine learning to assist you in establishing an effective retry strategy. When the time comes to retry a payment, Smart Retry analyzes over 15 characteristics of a transaction such as an account MRR, currency, payment amount, payment gateway, gateway response codes, the issuing bank region, when it last had a failed payment, and more. The analysis is then applied to Zuora's training dataset. The machine learning model then automatically retries an account's failed payment at the optimal times.

  1. On the Customer Groups tab, click the Menu icon in the Actions column and then click Edit Group . The Update Customer Group window opens.
  2. In the Smart Retry section, enable Smart Retry . The Smart Retry settings are displayed.
  3. Complete the configuration details.
    • Stop Retry On Hard Declines : If enabled, the Configurable Payment Retry stops the smart retry cycle for any payment with a gateway response code mapped to hard decline. Once the smart retry cycle is stopped, the Final Workflow is triggered. The smart retry cycle continues for all the other response codes such as soft decline, system error, or different custom mapping till the attempts have been exhausted or the payment is received.
    • Initial Workflow - Optional. Select the workflow to be triggered at the time the account/invoice enters the retry process. The workflow is triggered only once at the start of the retry cycle and would not be called for subsequent attempts. In the drop-down list, workflow names are listed based on the Workflow API token entered on the Settings page. The Workflow API token points to a specific Workflow instance where the names of configured workflows are retrieved.
    • Retry Window - Specify the days for the retry window, from the time the payment enters retry until the last attempt can be made. The minimum number of days depends on the number of attempts. An inline message will prompt you if the number of days is not valid. The maximum number of days allowed is 90.
    • Number of Attempts - Specify how many attempts Configurable Payment Retry will execute on the failed payment. If you enter 5, you will see a total of 6 attempts because the first attempt is executed by the payment run and then 5 additional attempts by Configurable Payment Retry. The maximum number of attempts allowed is 20.
    • Final Workflow:
      • The final workflow is only triggered when at the last attempt of the payment retry cycle.

      • When a retry cycle has a successful payment and the retry cycle completes, the final workflow is not triggered.

  4. Click Update . Smart Retry is enabled for this customer group.

If Smart Retry is enabled for a customer group, an indication is shown for this group on the Customer Groups tab, and the Edit Retry Rules menu will not be available for this group. To enable editing retry rules manually, disable Smart Retry in the Update Customer Group window and click Update .