Using the Advanced Payment Manager feature

Knowledge Center > Collect > Advanced Payment Manager > Using the Advanced Payment Manager feature

Using the Advanced Payment Manager feature

Before using Advanced Payment Manager, you need to complete the configuration. See Set Up the Advanced Payment Manager Feature for details.

Perform a one-time payment run

  1. In the Payment Runs section on the landing page, click the button to view all custom payment runs.
  2. On the Advanced Payment Runs page, click + New Subscription Payment Run.
  3. Select Invoice parameters to process with payment run.
    Only the accounts with the APM field set to "True" will be processed.

    • All Customers - Process all open invoices from all accounts.
    • Custom Query - Process invoices that meet specific criteria defined by customizable logic.
    • Filter By - Select filters to identify a specific group of invoices to be paid.
  4. Enter the target date for the payment run.

  5. Click Create.

Create a payment run schedule

  1. On the landing page, click the button in the Active Schedules section to view all recurring payment run schedules.

  2. On the Payment Schedules page, click + New Payment Run Schedule.

  3. Select Invoice parameters to process with payment run.

    Only the accounts with the APM field set to "True" will be processed.

    • All Customers - Process all open invoices from all accounts.
    • Custom Query - Process invoices that meet specific criteria defined by customizable logic.
    • Filter By - Select filters to identify a specific group of invoices to be paid.
  4. Enter Date and Schedule details:

    • Select the desired time zone from the dropdown menu

    • Select the frequency of the payment run

      Minutes, Hourly, Daily, Weekly, Monthly, Yearly

      Complete specific time frame details. Start times are in military time.

    • No further action is needed for the Interval field

  5. Click Create.

View the details of a payment run

A summary of recent payment runs are displayed in the Payment Runs section on the home page. In the summary, every payment run has an ID, which is different from the payment run ID in Zuora. For scheduled payment runs, the schedule ID is a number. For one-time payment runs, the shedule ID is always "Adhoc". 

collect_apm_pay_runs.png

To view a summary of all payment runs, click Click to view all custom payment runs.

collect_apm_pay_runs_all.png

To view the details of a particular payment run, click Show on the particular payment run in either of the summaries. 

collect_apm_pay_run_details.png

Additional details about the payment run, including invoices held, failed payments, and callout response are included in separate tabs.

Export all payments in a payment run

On the details page of a payment run, you can click Export Payments to export the payment details into a CSV file. 

The exported CSV file include the following payment details.

  • Account number
  • Account name
  • Account id
  • Account currency
  • invoice number
  • Debit memo number
  • Payment amount
  • Payment currency
  • Payment status
  • Payment gateway
  • Payment gateway response code
  • Payment gateway response

How does a payment run work in Advanced Payment Manager?

When a payment run is executed, the Advanced Payment Manager feature completes the following steps:

  1. Collect all invoices that meet the specified criteria.
  2. Segment invoices by subscription and payment method Id.
  3. Process payments for subscriptions individually with the specified payment methods. 

When processing payments, Advanced Payment Manager will check the balance for each subscription. If the balance is negative or greater than the overall invoice balance, it will also check these two conditions:

  • if the overall invoice balance is positive
  • all subscriptions on the same invoice use the same payment method and payment gateway

If both conditions are met, it will process the payment for the whole invoice. Otherwise, it will reject the payment for the invoice.

Last modified

Tags

Classifications

(not set)