Welcome to Zuora Product Documentation

Explore our rich library of product information

Create a Payment Run

The payment run is an asynchronous process that allows you to manage payments while continuing to use the Zuora application. Ensure you have the necessary permissions to create, edit, or delete payment runs.

The payment run is an asynchronous process running in the background, which means you can continue to use the Zuora application while the payment run is running.

  • You must have the Manage Payment Runs permission to be able to create, edit, cancel, and delete payments runs. This permission is enabled by default. When disabled, you can only view and download payment runs. An error message is returned if you try to perform actions for which you do not have permission. You must contact your Zuora tenant administrator to request a change to your user permissions.

  • When no payment profile is applied to a subscription, the payment run uses the default payment method. In such cases a standalone payment profile will be created for invoice within that subscription.

To create a payment run:

  1. Navigate to Payments > Payment Runs in the left navigation section.
  2. Click new payment run .
  3. Select whether you want to create a payment run for Multiple Customer Accounts or Single Customer Account .
    • If you select Multiple Customer Accounts , you can select All Customer Accounts , or filter by batch, bill cycle day, currency, payment gateway, or invoices in a bill run. If the Multiple Currencies feature is enabled, you can filter the accounts by currency based on the customer's billing document.

    • If you select Single Customer Account , search for the customer account to use.

  4. Optionally, select Apply Credit Balance to the invoice before attempting payment . The target date of the payment run must be on or before the date when the payment run is executed. Otherwise, the invoice might be charged by using an electronic payment method rather than by applying the credit balance. For example, if the payment run is executed on September 2 but you set the target date of the payment run to September 3, the credit balance amount might not be applied to the invoice.
  5. Optionally, select Process a single Payment for all Invoices that are due on an account .
  6. Optionally, select Process payments even if the default payment method is closed . If you select this option, the payment run will attempt to process a payment even if the default payment method is closed. When enabled, this will force a payment that will likely decline. However, there are use cases where an error payment is desired. Contact Zuora Global Support for more information.
  7. If you have the Invoice Settlement feature enabled, the following options are available:
    • Auto-apply unapplied credit memos during payment runs: Select this check box to auto-apply the unapplied credit memos on invoices and debit memos for a customer account. If you select the Exclude from auto apply rules check box when creating a credit memo, this auto-apply rule will not take effect for the credit memo.

    • Auto-apply unapplied payments during payment runs: Select this check box to auto-apply the unapplied payments on invoices and debit memos for a customer account.

    • The payment amount is applied to the invoice based on the Effective Date only.

  8. Enter a Target Date for the payment run. The target date is the day you are collecting the payments. The run will collect outstanding invoices that have auto-pay enabled and that have been posted.
  9. Click create payment run .
  10. Upon completion of the payment run, Zuora sends an email notifying you that the payment run has completed.