Welcome to Zuora Product Documentation

Explore our rich library of product information

Configure payment option for Invoice Only

Configure lockbox settings to process payments using the Invoice Only option, including overpayment and underpayment behaviors, invoice number prefixes, payment methods, and optional matching and review features.

Ensure that you have the required permissions to configure lockbox settings in your Zuora tenant.

Use this payment method option if you selected Invoice Only as the processing option when you configured the basic settings of a bank file format.

  1. Configure the overpayment behavior.

    An overpayment occurs when the payment amount exceeds the invoice amount. Select one of the following options:

    • Reject Lockbox Record: Zuora does not accept the payment.
    • Pay as Credit Balance on Account: Zuora processes the invoice payment and applies the remaining balance as a credit on the customer's account.
    • Find Next Oldest Invoice (if none, create credit): Zuora pays the current invoice and applies the remaining balance to the most recent outstanding invoice. If no outstanding invoice exists, Zuora applies the balance as a credit on the account.
  2. Configure the underpayment behavior An underpayment occurs when the payment amount is less than the invoice amount. Select one of the following options:.
    • Reject Lockbox Record: Zuora does not accept the payment.
    • Process Lockbox Record: Zuora processes the payment and leaves the outstanding balance on the customer's account.
  3. Specify the invoice number prefix used in invoice numbering. To enter multiple prefixes, separate them with commas.

    For example, if company Z identifies its invoices with a company-specific numbering format such as ZCODE11223344 or ZCODE00001234, enter ZCODE as the invoice number prefix.

  4. Select the Payment Method.
    • Cash
    • Check
    • Wire Transfer
    • Other
  5. Optional: Select Lenient Matching.

    Lenient matching helps you avoid unnecessary error reports by matching lockbox invoice and account numbers to Zuora fields without requiring standard or exact numbers. Zuora recommends that you enable lenient matching, which follows these rules:

    • Invoice and account numbers cannot exceed 8 digits. Otherwise, Zuora rejects the file.
    • If an invoice or account number contains fewer than 8 digits, Zuora adds leading zeros so that all invoice and account numbers contain 8 digits. For example, if the lockbox file lists an invoice as 1234, lenient matching recognizes it as INV00001234.
  6. Optional: If the Invoice Settlement feature is supported, select Invoice Settlement.

    For more information, see Invoice Settlement.

  7. Optional: Select File Processing Review.

    When you enable this option, you can review the ingested payment records before Zuora processes the payments. Files awaiting review remain in the Paused status until you take further action.

    For details about how to review payment records on the Runs tab, see View lockbox runs.

  8. Click Create Lockbox.

Zuora creates the lockbox with the specified configuration, and it is ready to process incoming payment files according to your defined behaviors.