DEV Community

Dudko Development
Dudko Development

Posted on Originally published at ad.miniaccountant.app

Your client paid less than the invoice because they withheld tax. Here's how to record it

You invoiced $1,000. The money arrives and it's $900. No note, no dispute, and the
client's accounts team says it's "tax". If you work for clients in other countries,
this happens sooner or later, and the first time it does it's easy to book it
wrong.

This page explains what's going on in plain words and how to record it so your
books still make sense. It isn't tax advice. Whether you owe anything, and whether
you can get the withheld amount back or set it against your own tax, depends on
your country and on any treaty between it and the client's country. That part is a
question for your tax authority or an accountant.

What "withheld" means

Some countries make the payer, not you, collect part of the tax on certain
payments. The client takes a slice off before paying you and sends that slice to
their tax authority in your name. They don't keep it. In the IRS's own words, the
person who does this is a withholding agent.

So the $100 isn't a discount and it isn't a bank fee. It's tax that was paid on
your behalf, out of money you earned.

The US case: W-8BEN and 1042-S

If your client is American and you aren't, the paperwork usually starts with
Form W-8BEN. You fill it in and give it to the client, not to the IRS. The
IRS instructions for Form W-8BEN say to
give it to the person asking for it before the payment is made, and that without
it the withholding agent may have to withhold at the 30% rate or the backup
withholding rate.

Where does 30% come from? The IRS page on
NRA withholding
describes it as the general rule for US-source income paid to a foreign person,
and says a lower rate, or none, may apply under a tax treaty between your country
and the US. That's what the treaty section of the W-8BEN is for.

The word that does the work there is US-source, and it surprises people. The
IRS's summary of source rules
puts the source of pay for personal services where the services are performed.
Royalties for copyrights and similar property are sourced where the property is
used. So, roughly:

  • Work you do from home, outside the US, for a US client is sourced outside the US by that table. The W-8BEN is still how you show the client you're a foreign person; whether anything should be withheld is a question for your adviser.
  • Licensing fees or royalties for something used in the US are a common reason real withholding shows up.
  • Work done while you're physically in the US is a different case. The W-8BEN instructions say not to use that form to claim an exemption on pay for personal services performed in the United States; Form 8233 or Form W-4 is used instead.

If the client did withhold, they report it on Form 1042-S. The
Instructions for Form 1042-S say it must
be filed with the IRS and furnished to the recipient of the income by March 15 of
the following year. That copy is your proof of how much was withheld. See also the
IRS page About Form 1042-S.

If a US client took 30% off and you think your treaty rate is lower, or that the
income wasn't US-source at all, raise it with the client and your adviser. Don't
fix it in your books by pretending the money never existed.

Other countries do this too

The US isn't special here. In India, a client deducting TDS gives you a
Form 16A,
the TDS certificate for income other than salary. In the Philippines, the
certificate is BIR Form 2307,
the Certificate of Creditable Tax Withheld at Source. The names change
and the logic doesn't: the client pays part of your tax, and hands you (or should
hand you) a certificate that proves it. Your own tax authority's site is the place
to read what the certificate means for you.

Three ways people record it wrong

Write the $100 off as a discount. Now your income says $900. But you earned
$1,000, and the certificate the client files says so too. Your records and theirs
disagree, and the tax that was paid for you has vanished from your books.

Leave the invoice as partly paid. It sits there as $100 overdue forever, and a
month later you're chasing a client who already paid in full.

Record $900 and move on. Same problem as the discount, without even a note
explaining the gap.

The version that holds up has three parts: the invoice is closed, income is the
full $1,000, and the $100 is visible somewhere as tax withheld, next to the
certificate that backs it.

Recording it in Mini Accountant

Mini Accountant is ours, so read this section with that in mind. Every feature in
it is free on iPhone, iPad, Android and the web; the optional Pro subscription only
removes the "Powered by Mini Accountant" line from invoices and reports.

The numbers below are demo data from our own test account: a demo customer,
one $1,000 invoice with no VAT, paid $900 with $100 withheld. Nothing here is a
real client.

Before the payment, the invoice shows as Unpaid, $0.00 of $1000.00.

An invoice card in Mini Accountant marked Unpaid, $0.00 of $1000.00, demo data

To record the payment:

  1. Go to Invoices and tap the pencil on the invoice to open it.
  2. Tap Add Transaction.
  3. Set the date and enter what actually reached you as the Transaction Sum: 900.
  4. Open Advanced. It's collapsed by default, which is why people miss it.
  5. Enter the withheld amount in Tax withheld by client: 100.
  6. Tick to confirm, then Save the invoice.

The Add Transaction dialog: Transaction Sum 900, Advanced expanded, Tax withheld by client 100, demo data

The transaction line on the invoice reads "$900.00 x 1 = 900.00 · Withheld:
$100.00". One thing to know: the Transactions total at the top of that screen
shows $900.00, the cash you received. The withheld part appears on the line itself.

The invoice's transaction line showing $900.00 and Withheld: $100.00, demo data

Back on the list, the invoice is Paid at $1000.00. Not Partial, because the
$900 received and the $100 withheld together settle it.

The same invoice card, now marked Paid at $1000.00, demo data

The Revenue report then counts the income at the full amount and shows the
withholding in a column of its own. For a range holding only this invoice: Taxable
Base 1000.00, Withheld 100.00, Revenue 1000.00.

The Revenue report for November 2026: Taxable Base 1000.00, Withheld 100.00, Revenue 1000.00, demo data

That's the record you want: income at $1,000, the $100 visible as tax withheld by
the client, and an invoice nobody will chase.

What it doesn't do

Better to know this now than after you've moved your books over:

  • The withheld amount is shown, not subtracted. The Revenue report puts it in its own Withheld column. It doesn't take it off the Tax Fee figure or show you a "tax still due" number. Whether and how that $100 counts against what you owe is your country's rule, and you apply it.
  • No certificate tracking. There's nowhere to attach a 1042-S, 16A or 2307, or to tick off which ones have arrived. Keep them in a folder next to the invoice number.
  • No rate lookup. It won't tell you what a client should have withheld under a treaty. You enter what they actually took.
  • Not double-entry. There's no "withholding tax receivable" account. If your accountant needs one, they'll set it up in their own system; the Revenue report is what you hand them.

If none of that gets in your way, you can start without an account and register
later from the menu to keep your data, at miniaccountant.app.


Originally published at https://ad.miniaccountant.app/blog/tax-withheld-by-client.

Top comments (0)