Construction progress payments in Xero: retention, part-pays, and matching

Construction accounts receivable rarely offers a clean full-invoice payment. Work is billed in progress claims, clients pay part of a claim while assessing the rest, and a slice of every payment is held back as retention until the job is signed off. Reconciling this in Xero means recording payments that almost never equal the invoice in front of them, which is exactly the situation Xero's simplest tools do not expect.

The three things that complicate the match

• Progress claims: revenue is billed in stages against a contract, so a single job produces a stream of invoices over months.
• Part-payments: clients commonly pay part of a progress claim now and the balance later, leaving invoices legitimately part-open for extended periods.
• Retention: a fixed percentage of each claim is withheld until practical completion or the end of a defects period, so the payment is short by design.

Recording retention correctly

Retention is the piece people get wrong. The client is not short-paying and they are not disputing; they are contractually holding back money you will receive later. If you record the retained amount as if the invoice were simply part-paid, the retention becomes invisible, buried in a general outstanding balance, and it is easy to forget to claim it when it falls due.

Matching a construction payment, step by step

• Identify the progress claim the payment relates to, using the contract or claim reference.
• Separate the components: what is being paid now, what is retention held back, and whether any part is disputed.
• Record the cash received against the invoice as a part-payment for the paid portion.
• Account for retention deliberately, so the withheld amount stays visible and claimable, not lost in the invoice balance.
• Confirm the paid portion plus retention plus any dispute equals the claim, so nothing is unexplained.

Why the volume sneaks up on you

A single job is manageable. A builder running many jobs at once produces many concurrent progress claims, each part-paid on its own timeline, each with its own retention accruing. The reconciliation is not hard per line; it is hard because the lines multiply and each carries state, how much is paid, how much retained, how much still to claim. That state is precisely what gets lost when the work is done by hand under time pressure.

Where matching software helps and where judgement stays

The mechanical part, tying a payment to the right progress claim, splitting the paid portion from the retained portion, and keeping the arithmetic balanced, is deterministic and automatable. The judgement, whether a shortfall is retention or a dispute, whether to claim retention now or wait for sign-off, stays firmly with the person who knows the job. A good tool does the matching and surfaces the state clearly; it does not pretend to know your contracts.