Welcome to Zuora Product Documentation

Explore our rich library of product information

Configure payment options for Document Only

Configure how the lockbox handles overpayments and underpayments, identifies billing documents by prefix, and processes payment records for Document Only payments.

When you create a lockbox, you configure how the system handles overpayments and underpayments, identifies invoices and debit memos by prefix, and processes payment records from the ingested files.

  1. Configure the overpayment behavior.

    Overpayment refers to a scenario in which the payment amount is greater than the debit memo or invoice amount. Select one of the following options:

    • Reject Lockbox Record - The system does not accept the payment.
    • Pay as Credit Balance on Account - The system processes the debit memo or invoice payment, and the remaining balance becomes a credit on the customer's account.
    • Find Next Oldest Document of Same Type (if none, create credit) - The system pays the current debit memo or invoice and applies the remaining balance to the most recent outstanding billing document of the same type. If no outstanding debit memo or invoice exists, the system places the balance on the account as a credit.
  2. Configure the underpayment behavior.

    Underpayment refers to a scenario in which the payment amount is less than the debit memo or invoice amount. Select one of the following options:

    • Reject Lockbox Record - The system does not accept the payment.
    • Process Lockbox Record - The system processes the payment, and an outstanding balance remains on the customer's account.
  3. Specify the debit memo number prefix used in debit memo numbering.

    To enter multiple prefixes, separate them with a comma.

    For example, Company Z identifies its debit memos by a company-specific debit memo numbering format such as DMCODE11223344 or DMCODE00001234. In this case, the debit memo prefix is DMCODE.

  4. Specify the invoice number prefix used in invoice numbering.

    To enter multiple prefixes, separate them with a comma.

    For example, Company Z identifies its invoices by a company-specific invoice numbering format such as ZCODE11223344 or ZCODE00001234. In this case, the invoice number prefix is ZCODE.

  5. Select the Payment Method.
    • Cash
    • Check
    • Wire Transfer
    • Other
  6. Optional: If you use the Invoice Settlement feature, select Invoice Settlement.

    You must enable this option when the feature is supported. For more information, see Invoice Settlement.

  7. Optional: Select File Processing Review.

    When you select this option, you can review the ingested payment records before the system processes the payments. Files awaiting review remain in the Paused status until you take further action. For more information about reviewing payment records on the Runs tab, see View lockbox runs.

  8. Click Create Lockbox.

The lockbox is created and ready to process incoming payment records according to your configured settings.