Smart Match customization
Configure how Smart Match uses adjustments, credit memos, customer identification, and remittance rules so it can automatically reconcile payments to invoices.
You do not write rules for Smart Match. You configure what it is allowed to use. Five settings shape every result:
Adjustments
Their priority order
Credit memos
Customer identification
Remittance reading
Adjustments
Go to .
- Level (invoice adjustment or payment adjustment): invoice adjustments are calculated per invoice, e.g. an early-payment discount. A payment adjustment is one amount on the whole payment, e.g. a bank charge, and covers only what is left after invoice adjustments.
- Rule (exact %, up to %, exact amount, up to amount, or a list of exact values): exact allows only that value. Up to allows anything from zero to the limit. With a list, the smallest value that works is used.
- Qualifying period (number of days): the invoice adjustment applies only when payment date minus invoice date is within the period, in calendar days. Checked per invoice.
- Distribute proportionally (payment adjustments only): spreads the payment adjustment across the matched invoices by invoice amount instead of one payment-level line.
- Priority (drag to reorder): the order in which adjustments are tried. See Priority order below.
- Percentages on the same invoice add up: 1% discount plus 2% VMS fee is 3% off. They are never compounded and never applied to the combined total of several invoices.
- When an invoice carries its own limit for a named adjustment, Smart Match may use any amount up to that limit on that invoice, replacing the account-wide rule, even an exact one. The qualifying period still applies.
- A payment adjustment never exceeds its limit. If the leftover is bigger, Smart Match tries another combination.
- If the remittance states an adjustment amount (for example, "Bank charge 25.00"), Smart Match uses that amount and only checks it is within your limit.
Priority order
Smart Match tries your top adjustment first, then the top one combined with others, then starts again from the second, and so on. It stops at the first solution that reconciles, so the order decides which explanation wins.
Example: Discount (up to 2%) is first and Bank Charge (up to $50) is second. A $10,000 invoice paid with $9,975 is recorded as a $25 discount, because the first adjustment alone explains it. If short payments like this are usually bank fees, move Bank Charge above Discount or make Discount an exact percentage.
If the remittance names an adjustment explicitly, that value wins over the priority order.
Credit memos
Credit memos take a place in the same priority list as adjustments. Smart Match applies a credit memo only when all of these are true:
Credit Memo is in your adjustment priority order
The credit memo is open in Zuora, and if it is tied to specific invoices, it is used only on those
It is needed to make the payment reconcile, not merely because an amount happens to match
Without a remittance, Smart Match does not pick credit memos on its own. A negative line on a remittance (e.g. "INV-201 −200") is matched to an open credit memo when Credit Memo is in your priority order. A credit memo that fully offsets an invoice shows that invoice with an applied amount of 0.00. For more information, refer to Credit Memo for posting details.
Customer identification
Under Smart AI configurations, choose which signals identify the sender of a remittance: sender email, sender domain and payer name. When the sender is an AP portal or consolidator such as Coupa, Tipalti or Taulia, the email signal is ignored automatically because these portals share generic domains. Add aliases on a customer for alternative trading names, and turn on Parent & Child to group related customers.
Remittance reading
- Account guidance: your alternative identifiers, the adjustment names your customers use, and a note on how to identify invoices and other entities.
- Customer guidance: column mapping, format notes and additional notes for one customer. Customer guidance wins over account guidance.
- Identifier variants: accepted forms of invoice, PO and credit memo numbers, e.g. INV-001, 001, INV001.
- Match tolerance (default ±$1 or ±0.5%): a remittance still matches a payment within this difference, covering rounding, bank charges and withheld tax.
- Remittance validity (default 30 days): older remittances are treated as expired and not used.
What you cannot change
The fallback order (oldest invoice first), the $1.00 tolerance on the final check, and the order used to choose between valid combinations are fixed for all accounts.