Welcome to Zuora Product Documentation

Explore our rich library of product information

Configure system settings

Learn how to configure system settings for retry logic, including setting time zones, retry levels, and enabling payment processing options.

  • You created the Configurable Payment Retry instance by using an OAuth credential.

  • Enable Events and Notifications feature. If this feature is not enabled in your Zuora tenant, contact Zuora Global Support to request enablement.

  • If you want Configurable Payment Retry to trigger a workflow as a retry action, you must install Workflow and create a workflow that implements the additional retry logic. Configurable Payment Retry uses the endpoint and API token of that workflow.

  1. Open Configurable Payment Retry.
  2. Click the Settings tab.

    The API Token field at the top displays the API token for Configurable Payment Retry. You use this token to configure the payment run callout notification in a later step.

  3. On the Settings tab, configure the following options:
    • Instance time zone: Select the same time zone as your Zuora environment to avoid payment errors.
    • Retry level: Select the level against which retry attempts are counted. For CPR, Invoice is the preferred level.
    • Process a single Payment for all Invoices/Debit Memos that are due on an account: Switch on or off as needed.
    • Process payments even if the default payment method is closed: Switch on or off as needed.
    • Auto-apply unapplied credit memos during payment runs: Switch on or off as needed.
    • Auto-apply unapplied payments during payment runs: Switch on or off as needed.
    • Default label: Select the default code mapping label that classifies unknown gateway response codes. Skip this setting if you plan to use Smart Retry.
    • Workflow API token: This token is generated during feature installation and identifies the Workflow used for Workflow callouts in the retry logic.
  4. Click Save All Settings to save your changes.