Skip to main content

Using the Configurable Payment Retry feature

Zuora

Using the Configurable Payment Retry feature

After completing the customer group and retry logic configuration of Configurable Payment Retry, you need to ensure that the accounts on your tenant have auto-pay enabled and have an electronic payment method associated to them. Only payments collected via the Zuora payment runs will enter the retry cycles of Configurable Payment Retry.

Activation of the retry logic

Upon the successful completion of a Payment Run, Configurable Payment Retry’s logic is activated. Initial payments from the payment run that are not successful will be sent into the retry system and will trigger the configured retry logic for their gateway response.

See Payment Runs for more information about payment runs.

Auto-pay status change

No matter what the retry level is (account or invoice), once an invoice enters the retry cycle in Configurable Payment Retry, the invoice-level auto-pay will be turned off.
If the retry level is set to Account, when the retry cycle completes and no payments have been received, the account-level auto-pay will be turned off. This is to prevent further retries and to signal that further actions are needed. If payments have been successfully collected in the retry cycle, the account-level auto-pay will NOT be turned off.

Once the account-level auto-pay is turned off, invoices or debit memos for the account will not be picked up in the next payment run. If you want the invoices and debit memos to be picked up during a payment run, you need to manually turn on the auto-pay setting for the account. 

If the retry level is set to Invoice, when an invoice enters the retry cycle, Configurable Payment Retry will not try to turn off the account-level auto-pay.

View account-level and invoice-level retry status

Once Configurable Payment Retry is installed, a custom field "Retry Status" will be added to the Account and Invoice (or Debit Memo, if Invoice Settlement is enabled on your tenant) objects. You can use the values of these two fields to determine the retry and payment status.

The values of these two fields are managed by Configurable Payment Retry based on the settings and the retry logic. Zuora recommends that you do not change the values of these two fields. 

To view the retry status of an account, navigate to the details page of the account.

collect_cpr_account_retry.png

To view the retry status of an invoice or debit memo, navigate to the Additional Fields section on the details page of the invoice or debit memo.

collect_cpr_invoice_retry.png

Account retry status

  • In retry: The account is active in a retry process. It indicates that either an invoice of the account or the account enters a retry cycle. 
  • Complete: The retry process has completed and payments have been collected.
  • Failure: The retry process for the account has completed and payments have not been collected.
  • Blank: All accounts start with this status (no value for the field). Once the account or an invoice of the account enters a retry process, this field will begin to be updated. The field will never be blank again unless it is manually modified to be blank (which is not recommended).

Invoice or debit-memo retry status

  • In retry: The invoice or debit memo is active in a retry process.
  • Complete: The retry process has completed and the payment has been collected.
  • Complete - External: The retry process has completed due to a payment made outside of the retry process. It means that an ad hoc payment has been made during the retry process. The next time Configurable Payment Retry attempts to retry a payment, it recognizes the payment and updates the status to Complete - External.
  • Failure: The retry process has completed and no payments have been received.
  • Blank (no value): All invoices or debit memos will start with this status (no value for the field). Once the account or the invoice (debit memo) enters the retry process, this field will begin to be updated. The field will never be blank again unless it is manually modified to be blank (which is not recommended).

View retry attempts

To monitor the progress of your retry logic, complete the following steps.

  1. In your Zuora tenant, click the desired account and select Transactions > Payments.

  2. View the Status of each payment.

    • Error - Payment was unsuccessful and is in retry attempt
    • Processed - Payment was successfully processed

    CPR_Using_1.png

  3. Click the Payment Number to view payment details.

    CPR_Using_2.png

    The Payment window opens:

    CPR_Using_3a.png

    • Error Message: Displays the error message from the selected payment gateway.
    • Comment: Displays information about the status of the account in the retry process. You may have noticed that attempt numbers in the comment start with 2. This is because Attempt 1 is triggered via a payment run in Zuora and subsequent retries are triggered in Configurable Payment Retry.

Understand the home page

Use metrics on the home page to evaluate the effectiveness of your payment retry attempts for increased collection rates.

  1. Recovery Rate: Displays the % of the money recovered from accounts in retry

  2. Day: The average number of days invoices are unpaid before collection

  3. Recovered: Total amount of money recovered from accounts in retry

  4. Attempts: Displays the average number of attempts required to recover funds

  5. Customer Groups: List of all customer groups

  6. Response Codes and Groups: Review all gateway response codes and map their responses

  7. Responses Grouped by Code Type: Graph that displays the different type of response codes to declined invoices

    • Success
    • Hard Decline
    • Soft Decline
    • System Error

    Custom code types will be reflected in graph

  8. Funds Collected - Displays total amount collected, the exact percentage of collected funds is displayed in the Recover Rate metrics (1)

  9. Codes by Customer Group - Breakdown of customer groups based on response code

CPR_Using_4.png

Tips

  • Ensure all accounts have auto-pay enabled.

  • Payments must come from a payment run to be picked up by Configurable Payment Retry

  • If there is a response code from the Gateway not recognized by the CPR feature, (i.e., a response code that has not been mapped and pre-loaded by Zuora), the feature will respond with configured label identified on the Settings page.