Smart Match process flow
Smart Match evaluates each payment through a four-step process to identify the customer, gather evidence, find matching invoices, and verify that the allocation reconciles, with a fallback strategy when no exact match is found.
Every payment goes through four steps:
Identify the customer
Gather the evidence
Find invoices that reconcile exactly
Check the result
-
Identify the customer. Smart Match looks for these signals, most reliable first:
Invoice numbers on the payment or its remittance
The payer name in the bank description or on the cheque
Aliases you have set on the customer
The sender's email address or domain, for email remittances
When your team posts a payment to a customer, Smart Match remembers that payer name for next time. If the payer belongs to a customer group, the payment is linked to the parent. For more information, refer to Parent-child matching.
If no customer is identified with enough confidence, the payment shows No Match and no invoices are suggested. Assign the customer and Smart Match runs again automatically.
-
Gather the evidence. Smart Match works only from what is in Zuora for that customer:
- Payment amount and payment date
- Open invoices, with amounts, dates and any invoice-level adjustment limits
- Open credit memos
- Remittance details from the bank description, a lockbox image or an email remittance
- Your adjustment rules and their priority order. For more information, refer to Smart Match customization.
-
Find the invoices. How Smart Match searches depends on how much the remittance tells it:
- Complete remittance (lists invoices whose amounts add up to the payment): Smart Match uses exactly those invoices. Any gap between an invoice's amount and the amount paid must be explained by a configured adjustment or a credit memo. It never swaps in other invoices.
- Partial remittance (lists some invoices, or the listed amounts don't add up to the payment): Smart Match keeps the listed invoices and searches the customer's other open invoices to cover the rest.
- No remittance: Smart Match searches combinations of open invoices that, after your adjustments, equal the payment.
Adjustments are tried in your priority order. Smart Match first looks for a solution using your top adjustment, adds lower-priority ones only when needed, and stops at the first combination that works.
When more than one combination works, Smart Match picks, in this order:
The one using your highest-priority adjustments
The one applying the same adjustments evenly across all invoices
The one with the oldest invoices
The one with the fewest invoices
The one with the smallest difference before adjustments
-
Check the result. Every result must reconcile, within a $1.00 rounding tolerance:
\text{Invoices} - \text{Credit memos} - \text{Invoice adjustments} - \text{Payment adjustments} = \text{Payment amount}Smart Match uses only the adjustment types you configured, within their limits. If no combination reconciles, it does not guess; it moves to the fallback.
When nothing reconciles: the fallback- Remittance present: the payment is applied exactly as the remittance states, same invoices and amounts, with no added adjustments.
- No remittance, one open invoice: the payment is applied to that invoice. A short payment leaves a balance open; an overpayment leaves the extra unapplied.
- No remittance, several open invoices: invoices are paid oldest first. An invoice is applied only if the remaining payment covers it in full; larger invoices are skipped, never part-paid. Anything left over shows as an unapplied amount.
Adjustments and credit memos are not used in the fallback. The result is Matched only when the applied amounts fully account for the payment; otherwise it is Partial Match and should be reviewed.
When Smart Match runs again, that is, Smart Match re-runs automatically when:- The payment's customer changes
- The payment's amount, currency or subsidiary is edited
- A remittance is linked, unlinked or edited
- Another payment is applied to any of the same invoices