Welcome to Zuora Product Documentation

Explore our rich library of product information

Example lockbox scenarios

This document outlines various lockbox scenarios, detailing how the lockbox application processes payments based on the accuracy of account and invoice information.

The following scenarios explain what happens when certain information matches or doesn't match. The scenarios column describes the data coming into the lockbox, and the result column explains what the lockbox application does with the payment.

Scenarios

Account

Invoice

Date

Amount

Result

When the account and invoice number are correct.

A00003054

Z-11472-INV-00000051

11/29/2022

10.00

Payment is created on the correct invoice.

When the account number is blank.

Z-11472-INV-00000051

11/29/2022

20.00

Payment is created on the correct invoice.

When the account number is bad.

BAD123

Z-11472-INV-00000051

11/29/2022

30.00

Payment is created on the correct invoice.

When the account number is wrong.

A00003070

Z-11472-INV-00000051

11/29/2022

40.00

Payment is created on the correct invoice.

When the invoice number is blank.

A00003054

11/29/2022

50.00

Payment created as unapplied payment on account.

When the invoice number is bad.

A00003054

BAD456

11/29/2022

60.00

Payment created as unapplied payment on account.

When the invoice number is wrong and already paid.

A00003054

Z-11472-INV-00000050

11/29/2022

70.00

Payment created as unapplied payment on account.

When the wrong invoice is for a different account.

A00003054

Z-11472-INV-00000059

11/29/2022

80.00

Payment is created on the wrong invoice on a different account. With Invoice Settlement Enabled When the process by invoice is first selected, this is expected result. If needed, the customer billing team can manually unapply payment from the wrong invoice and then reapply payment to the correct invoice on the correct account. Without Invoice Settlement External Refund and new external payment.

With a blank account and invoice number.

11/29/2022

90.00

The payment failed - expected.

With a bad account and bad invoice number.

BAD123

BAD456

11/29/2022

100.00

The payment failed - exp