Stripe Underpayment Threshold and QuickBooks

Stripe can mark a short-paid invoice as paid and credit the gap. What the setting does, and how to book the difference in QuickBooks.

Acodei Content Team · 11/21/2026 · 15 min read

You invoice a customer in Germany for $4,850.00 on net 30 terms. They pay by international wire, exactly as asked, and $4,832.00 lands in Stripe. Somewhere between their bank and yours, an intermediary bank took $18.00. Nobody did anything wrong, and nobody is going to send you a second wire for eighteen dollars.

Without help, that invoice stays open in Stripe for $18.00 until someone deals with it by hand. Stripe has a setting for exactly this case: if a payment comes in within an amount you choose of the invoice total, Stripe applies a credit for the rest and marks the invoice paid.

The setting saves a lot of small, annoying cleanups. It also quietly turns a cost into a closed invoice, and that cost still has to land somewhere in QuickBooks. This guide covers what the setting does, how it interacts with bank transfers and cash balances, how a bookkeeper should treat the written-off difference, and what to check in QuickBooks the first time it fires.

Keep your QuickBooks receivables tied to Stripe. Acodei's Invoice Sync creates a QuickBooks invoice when a Stripe invoice is finalized and applies the payment when Stripe marks it paid. Start a free trial.

What the setting does

Stripe describes it in its automatic collection guide under the name Automatically reconcile partial payments that meet a minimum:

"You can instruct Stripe to mark an invoice as paid if it's partially paid within the set amount. For example, if the payment received from your customer is within 20 USD or less of the total (or at whatever amount you configure), then this setting applies a credit to the invoice for the outstanding amount. It then marks the invoice as paid."

Three things in that description matter for your books.

  1. It's a threshold, not a percentage. You set an amount. A $15 shortfall on a $40,000 invoice and a $15 shortfall on a $60 invoice are treated the same way. Think about your smallest invoices before you pick a number.
  2. Stripe applies a credit for the gap. The customer doesn't pay the difference, and nobody refunds anything. The invoice is closed by a payment plus a credit.
  3. The result is a paid invoice. Anything downstream that listens for "paid" will see a paid invoice, not a short-paid one.

Two names for one setting

Stripe's bank transfer guide describes what looks like the same feature in different words. It calls the amount an "underpayment threshold below which you consider it acceptable to automatically close the invoice and credit the customer the difference", and places it under Settings > Billing > Invoices > Adjustments and reconciliation, with the label Automatically write-off invoices.

The two pages don't agree on the label or the settings tab, so look for either name in your Dashboard. What both agree on is the effect: a payment that is short by no more than your threshold closes the invoice, and Stripe covers the gap with a credit.

The bank transfer guide's own name for it is the more honest one for bookkeeping purposes. From the books' point of view, this is a write-off.

Where short payments actually come from

The bank transfer guide gives the main reason the setting exists: "Your customer's payment might be slightly less than the amount required to pay the invoice fully. This can be common with international wire transfers."

In practice, small shortfalls come from a handful of places:

  • Intermediary and receiving bank fees on wires. A cross-border wire can pass through one or more correspondent banks, and each can deduct a fee from the amount in transit. The customer sends the right amount and you receive less.
  • Currency conversion on the payer's side. A customer paying a USD invoice from a EUR account converts at their bank's rate, and a rate that moves between quote and send can leave the transfer a little short.
  • Customers rounding down. An invoice for $1,249.87 paid as $1,249.00, or a customer who pays the pre-tax subtotal.
  • Early payment discounts the customer took on their own. Some accounts payable teams deduct 1% or 2% for paying early, whether or not your terms offer it.

The first two are costs of getting paid. The last two are decisions the customer made about your price. The setting treats all of them the same way, but your books shouldn't, and that's the main point of this guide.

How it works with bank transfers and the cash balance

Most short payments that hit this setting arrive as bank transfers, so it helps to know how Stripe handles a short transfer without it.

Stripe's bank transfer guide is explicit: "If the customer sends too little, Stripe partially funds an open Payment Intent. Invoices won't be partially funded and remain open until incoming funds cover the full invoice amount." Funds that can't be matched to anything go to the customer's cash balance, and Stripe sends the cash_balance.funds_available webhook. Our Stripe cash balance entry covers how that balance works.

So without the threshold, the $4,832.00 wire from the opening example sits in the customer's cash balance and the $4,850.00 invoice stays open. Somebody has to notice, decide, and act.

The threshold changes that in two places.

When funds arrive. A transfer within your threshold of an invoice can close it, with Stripe crediting the difference.

When you finalize a new invoice. Stripe's cash balance reconciliation guide says: "When you finalize an invoice, Stripe also checks the customer's existing cash balance. Stripe applies the balance if it can fully pay the invoice after accounting for your configured underpayment threshold. If the available balance is less than that amount, Stripe leaves the funds in the cash balance instead of partially applying them to the newly finalized invoice."

That second case catches people out. A customer with $4,832.00 sitting in their cash balance and a new $4,850.00 invoice can have that invoice closed the moment you finalize it, before anyone has looked at either.

Not the same as partial reconciliation

Stripe has a neighbouring setting with a similar name: Automatically reconcile partial bank transfer payments. It does something different. It lets Stripe apply a transfer that doesn't fully pay an invoice as a partial payment, leaving the invoice open with a smaller balance. Stripe says it "only attempt[s] a partial reconciliation if your customer provides an invoice number in the transfer memo", and that this setting "doesn't cause Stripe to partially apply an existing cash balance when you finalize a new invoice."

Underpayment thresholdPartial bank transfer reconciliation
What it does with a short paymentCloses the invoice and credits the gapApplies the payment and leaves the invoice open
Invoice status afterwardsPaidOpen, with a smaller amount remaining
Who covers the differenceYou do, through the creditThe customer still owes it
Needs the invoice number in the transfer memoNot statedYes
Applies when finalizing a new invoice against an existing cash balanceYesNo

Use partial reconciliation when you expect the rest of the money. Use the threshold when you don't, and you've decided the gap isn't worth chasing. Our partial payments guide covers the first case in full.

The credit is a real cost

Here is the part the Dashboard toggle doesn't say. When Stripe "applies a credit to the invoice for the outstanding amount", you have agreed not to collect money you invoiced. The invoice says $4,850.00 of revenue and receivable. The bank says $4,832.00 arrived. The $18.00 in between is a cost to your business, and someone has to decide what kind of cost it is.

Stripe's docs don't say which object it uses to record the credit on your account. One page says it "applies a credit to the invoice", and the other says it will "credit the customer the difference". Before you rely on the setting, let it fire once (or test it in a sandbox) and look at the closed invoice in the Dashboard. Note where the credit shows up, for example as a credit note on the invoice or as an entry in the customer's credit balance history. That tells you what any downstream system, including your accounting sync, actually received.

How to treat the difference in QuickBooks

There are three honest ways to book the gap. Pick one per cause, write it down, and apply it the same way every time.

Bank fees

If a bank took the money in transit, the gap is a cost of collecting payment. It belongs in an expense account alongside your other bank charges.

Intuit's guide to bank fees when matching transactions covers this case for a payment matched from the bank feed: "If you received less than the due amount on invoice because of bank fees", create an expense account with the detail type Bank charges, then "resolve the difference when matching the transaction from your bank feed." QuickBooks fills in the difference, you pick the Bank fees account, and Intuit says the result is that "Your transaction is now matched off against the invoice, and the bank fees are accounted for."

That method assumes you're matching a bank feed deposit to an invoice by hand. If your Stripe payments reach QuickBooks through a sync, the payment is already recorded, so use the credit approach in the section below instead.

Discounts and allowances

If the customer decided to pay less, for an early-payment discount they took or a rounding they chose, the gap is a reduction in what you sold for. Most bookkeepers record that against revenue (a discounts given or sales allowances account) rather than as an expense, so gross revenue and the discount are both visible on the Profit and Loss report.

This is also the case to watch. A customer who short-pays by a few dollars every month is getting an unagreed discount, and an automatic threshold means nobody notices. Run a report of credited shortfalls by customer every quarter.

Bad debt

If you tried to collect the difference and gave up, it's bad debt: revenue you recognised and won't receive. Our QuickBooks bad debt write-off entry walks through Intuit's method, which uses a Bad debts expense account, a non-inventory item that points at it, and a credit memo applied to the open invoice. For a sub-threshold gap that nobody chased, bad debt is usually the wrong label. Bank fees or a discount describe what happened more accurately.

Sales tax on the gap

If the invoice charged sales tax or VAT, the credit raises a question your tax adviser should answer once: does writing off part of the invoice reduce the tax you owe on it? The answer depends on the jurisdiction and on whether the gap is a price reduction or a collection cost. Don't let an automatic setting make that decision silently, invoice after invoice.

What to check in QuickBooks

The QuickBooks side depends on how the invoice got there.

If you enter Stripe invoices by hand, you need to apply the same credit Stripe applied. The usual pattern is the one Intuit uses for bad debt: create a non-inventory item for each treatment (for example Bank fees written off, pointed at your Bank fees expense account, and Payment discounts, pointed at your discounts account), put it on a credit memo for the gap, and apply that credit memo to the invoice in Receive payment. Our QuickBooks credit memo entry covers how credit memos post.

If you use Acodei's Invoice Sync, here is what is documented and what isn't. When a Stripe invoice is finalized, Acodei creates a QuickBooks invoice with its line items and tax lines. When the Stripe invoice is paid, by a successful charge, a manual payment (depending on your settings) or a credit balance offset, Acodei creates a payment receipt or credit memo and applies it to that invoice. When Stripe creates a credit note, Acodei creates a QuickBooks credit memo, linked to the invoice when possible and otherwise posted to the customer. Applying payments and credit memos to invoices automatically depends on the Automatically apply credits setting being on in QuickBooks, which our Automatic Application entry explains.

What Acodei's documentation doesn't yet describe is an invoice closed by a short payment plus a Stripe-applied write-off credit. So after the setting fires for the first time, check the invoice in QuickBooks:

  1. Find the QuickBooks invoice for the Stripe invoice and look at its open balance.
  2. If it's zero, open the transactions applied to it. Note whether the gap arrived as a credit memo and which item and account it used. If that account isn't where you want the cost to sit, agree the fix once with your accountant instead of editing each invoice by hand.
  3. If the balance equals the shortfall, the payment arrived and the write-off didn't. Clear it with a credit memo using the item for your chosen treatment, as described above. Do this once per invoice, and confirm the gap is still open before you do it, so the same shortfall is never cleared twice.
  4. Don't edit or delete the synced payment to make the numbers fit. Acodei's guidance is to resync from the Data Feed rather than change synced transactions by hand.

A worked example

Here is the opening invoice end to end, with a $20 threshold and the bank fees treatment.

Invoice. $4,850.00, net 30, sent to a customer in Germany with bank transfer instructions. In QuickBooks, the invoice shows $4,850.00 of income and $4,850.00 in accounts receivable.

Payment. The customer's bank sends $4,850.00. An intermediary bank takes $18.00 and $4,832.00 reaches Stripe. The shortfall of $18.00 is within the $20.00 threshold, so Stripe applies an $18.00 credit and marks the invoice paid.

Books, when it's handled correctly.

AccountEffect
Income$4,850.00, unchanged from the invoice
Accounts receivable$4,850.00 raised, then cleared by $4,832.00 of payment and $18.00 of credit
Bank fees (expense)$18.00
Cash, once Stripe pays out$4,832.00, less any Stripe fees

Books, when the credit never reaches QuickBooks and nobody looks. The invoice shows a $4,832.00 payment and an $18.00 open balance in QuickBooks, while Stripe shows it paid. It sits in the A/R aging report until a year-end review, by which point nobody remembers the wire. Multiply that by a few dozen international customers and the aging report stops being trustworthy.

Choosing a threshold

There's no right number, but there are good questions:

  • What does a typical wire fee cost your customers' banks? Look at the last six months of short international transfers and set the threshold just above the usual gap, not far above it.
  • What's your smallest invoice? A $20 threshold on a $25 invoice means a customer could pay $5 and close it. If you bill small amounts by bank transfer, keep the threshold low.
  • Do different currencies need different amounts? Stripe's example is "20 USD or less". Check how the setting handles invoices in other currencies on your account before you assume one number fits all of them.
  • Who reviews the credits? Put a monthly check on someone's calendar: list invoices closed with a credit, total the credits by customer, and look for patterns.

Frequently asked questions

What does "automatically reconcile partial payments that meet a minimum" do in Stripe?

If a customer's payment is within an amount you set of the invoice total, Stripe applies a credit to the invoice for the outstanding amount and marks it paid. Stripe's example is a payment within 20 USD of the total. Stripe's bank transfer guide describes the same idea as an underpayment threshold, under the label Automatically write-off invoices.

Does the customer still owe the difference after Stripe closes the invoice?

No. The invoice is marked paid and the gap is covered by a credit, so the customer owes nothing more on it. If you want to collect the difference, use Stripe's partial bank transfer reconciliation instead, which applies the short payment and leaves the invoice open for the rest.

How do I record a short payment caused by bank fees in QuickBooks Online?

Intuit's method for a payment matched from the bank feed is to create an expense account with the Bank charges detail type, then use the resolve the difference option when matching the deposit to the invoice and put the gap in that account. If the payment is already recorded by a sync, clear the remaining balance with a credit memo that uses an item pointed at your bank fees account.

Is an underpayment write-off bad debt?

Usually not. A gap caused by bank fees is a cost of collection and fits a bank fees expense account. A gap the customer chose, such as an early payment discount, is a reduction in price and fits a discounts account. Bad debt is for receivables you tried to collect and gave up on.

Does Stripe's underpayment threshold apply to an existing cash balance?

Yes. Stripe says that when you finalize an invoice it applies the customer's existing cash balance if it can fully pay the invoice after accounting for your underpayment threshold. If the balance is smaller than that, Stripe leaves the funds in the cash balance.

What does QuickBooks receive when Stripe writes off part of an invoice?

It depends on your setup. If you enter invoices by hand, you apply the credit yourself. Acodei's documentation covers paid invoices and Stripe credit notes, but not yet an invoice closed by a short payment plus a write-off credit, so check the QuickBooks invoice's open balance the first time the setting fires.

The short version

Stripe's underpayment threshold closes an invoice that's short by no more than an amount you choose, and covers the gap with a credit. It's useful for international wires, where a bank fee taken in transit is common. It also means you've written off part of an invoice without anyone deciding how to book it. Decide that once: bank fees, discounts or, rarely, bad debt. Set a threshold that fits your smallest bank transfer invoice, and check the first closed invoice in QuickBooks to confirm the gap went where you intended.

Let Stripe invoices and their payments flow into QuickBooks. Acodei's Invoice Sync creates the QuickBooks invoice when Stripe finalizes it and applies the payment when Stripe marks it paid, so your receivables come from Stripe instead of from manual entry. Start a free trial.

Share

Automate your Stripe to QuickBooks sync

Save hours every month. Acodei automatically syncs your Stripe transactions, invoices, and payouts to QuickBooks Online.

14-day free trial · card required · cancel anytime

How Acodei handles this in your stack

Stripe QuickBooks Integration

See how Acodei syncs Stripe payments, fees, refunds, invoices, and payouts into QuickBooks Online automatically.

Or go straight to a capability

Get more operational finance guides like this one

We will only send high-value product and finance content.