1. Home
  2. QuickBooks integration
  3. Stripe and QuickBooks

Stripe pays you net, so QuickBooks needs the sale and the fee as two lines

A QuickBooks Stripe integration posts each Stripe sale at its full amount, books Stripe's fee as its own expense, and matches each payout to the deposit in your bank. Stripe's API gives the gross, the fee and the net on every balance transaction. Refunds, disputes and instant payouts each need a rule of their own.

Checked 18 November 2026

Every Stripe balance transaction holds three numbers

Stripe already splits each sale for you. Its Balance Transaction object carries the gross amount, the fee and the net, and Stripe says the net is the amount minus the fee. All three come in the smallest unit of the currency.

Stripe’s API reference says to classify transactions for accounting with the reporting category, not the type. Map each reporting category to a QuickBooks account once, and the sync follows that map.

Scroll the table sideways to see every column.

Stripe record Where it lands in QuickBooks Online What to watch
Charge paid at checkout Sales receipt Intuit says a sale paid at the time gets a sales receipt
Stripe invoice paid Payment linked to the open QuickBooks invoice Intuit links a payment to the invoice it pays
Stripe fee A fee line on the deposit Stripe gives the fee on every balance transaction
Refund Refund receipt Stripe’s charge.refunded event covers partial refunds too
Dispute A deduction, plus a dispute fee Stripe takes the disputed amount out of your balance
Payout Deposit One deposit per payout, holding the payments it paid out

In Intuit’s linked transactions guide, a QuickBooks deposit can link to payments, sales receipts, transfers, journal entries and bill payments through its Deposit.Line.LinkedTxn element. Intuit’s limits page caps those links at 10,000 per transaction, journal entries aside. So one deposit can point at up to 10,000 of the sales a payout covered.

How the fee should land in QuickBooks

Post the sale at gross and the fee as an expense on the same deposit. Then the deposit total equals the payout, and the bank feed matches.

Create the fee account once. Intuit’s accounts guide says an account name must be unique, and tells apps to check that an account exists before making a new one. A sync that skips the check can fail when it tries to make the account again.

Stripe also has a balance type called tax_fee. Stripe describes it as tax it collects to pay to local governments, and says it is typically a tax on Stripe’s own fees. Keep it apart from the sales tax your customers paid.

Match each automatic payout, not each charge

Stripe’s payout reconciliation report has an itemized CSV with every payment, refund, dispute and fee inside a payout. The report works only when automatic payouts are on. Three details decide how the sync runs:

  • Wait for the event. Stripe sends payout.reconciliation_completed when the balance transactions in an automatic payout can be queried. Build the QuickBooks deposit after that event, not when the payout is created.
  • Use the right date. The report groups a payout by its estimated arrival date, not the date your bank posts the deposit. So the bank date and the report date can differ.
  • Carry your own IDs. Stripe says CSV exports can include your custom metadata, to match Stripe transactions with records in your accounting system. Put the QuickBooks invoice number in the metadata when the charge is made.

Instant payouts break this pattern. Stripe says you control their timing and amount, so it can’t tell which transactions each one holds. You reconcile those against your own history. Stripe points users on manual payouts, or anyone who would rather reconcile the Stripe balance like a bank account, to its Balance report instead.

Refunds and disputes pull funds out of later payouts

A refund comes out of your Stripe balance, so it lowers a later payout. Stripe’s payouts page shows how far that can go: refunds of earlier payments can push the balance below zero. Each refund needs its own record in QuickBooks.

Stripe fires charge.refunded whenever a charge is refunded, partial refunds included. That becomes a refund receipt. Intuit’s own MCP server, a tool that lets an AI app use QuickBooks, lists a create_refund_receipt tool.

Disputes cost more. Stripe fires charge.dispute.created when a customer disputes a charge with their bank. Stripe then deducts the disputed amount from your balance, as an adjustment whose source is the dispute. It also debits a dispute fee. Book the two apart, so each one matches its own line in Stripe.

QuickBooks Payments can post its own deposits

QuickBooks has its own payment service, and Intuit does more of the bookkeeping for it, with one setup step. Intuit’s payments guide covers card and eCheck payments. Its best practice is to set the sales receipt up for automatic reconciliation when the app records the sale. The app stores the charge’s CCTransId on the receipt, which Intuit calls fundamental to card and eCheck reconciliation. Once the payment settles, QuickBooks Online creates the deposit itself, plus a Purchase record for the fee.

Intuit adds that the Payments connection and the QuickBooks connection must be on the same company for that matching to work. Stripe sits outside QuickBooks, so a Stripe integration has to post the deposit and the fee on its own.

Both systems retry webhooks, so posts must be safe to repeat

A webhook is a message one system sends another when something changes. Stripe and QuickBooks both resend them, and both say events can arrive out of order.

Scroll the table sideways to see every column.

Rule Stripe QuickBooks Online
How long it retries Up to three days in live mode 10s, 20s, 30s, then longer gaps up to every 6 hours
Order Events may arrive out of order Events can arrive out of sequence
How fast to answer Return a 200 before updating the invoice in your books HTTP 200 within 3 seconds

Stripe adds that the same event can arrive more than once. So the sync logs each Stripe event ID and drops repeats. On Stripe’s side, every API v1 POST call accepts an idempotency key of up to 255 characters, so a retried call does its job once. On the QuickBooks side, Intuit strongly recommends a request ID on every call that changes data, so a retried call runs once. Intuit also advises a stable DocNumber, the form’s visible number, from your own system. Before retrying a failed create, query for that number first.

Speed limits matter for the first import. Stripe allows 100 requests a second in live mode and 25 in a sandbox. QuickBooks Online allows 500 requests a minute for each company, and a throttled call gets HTTP 429 and should wait 60 seconds. A busy account may post a daily summary instead of each charge. Even then, one QuickBooks transaction holds at most 10,000 lines, journal entries aside.

Instant payouts are where an AI agent earns its keep

Stripe leaves instant payouts to you, since it can’t say which charges each one paid out. That makes them the right first job for an agent. A custom agent can take an instant payout’s amount and date, search the charges and refunds that were available before it, and propose the set that adds up. A person approves the match before anything posts. See QuickBooks AI agents for the agent side and AI integration services for how we connect systems.

Bookkeeping and order sync are QuickBooks jobs we have run

Bookkeeping, inventory sync, order sync and invoicing are all jobs our team has run in QuickBooks. For other ways to connect QuickBooks, start at our QuickBooks integration page.

Questions

How do I record a Stripe payment with the fees?

Record the sale at its gross amount and the Stripe fee as an expense. Stripe gives both on each balance transaction, plus the net, which is the amount minus the fee. In QuickBooks Online, the sale is a sales receipt or a payment on an open invoice. The fee goes on the deposit as its own line, so the deposit equals the money that reached your bank. Your accountant picks the fee account.

Can QuickBooks accept ACH payments?

Yes, through QuickBooks Payments. Intuit's Payments API guide covers payments by credit card or eCheck, and its own sample charge is labeled ACH/echeck. When the app sets the sales receipt up for automatic reconciliation, QuickBooks Online creates the deposit once the payment settles, and records the fee as a Purchase. Money taken through Stripe gets none of that, so a Stripe integration posts the deposit and the fee itself.

Does Stripe offer a QuickBooks Online integration?

For platforms, yes, in private preview. Stripe's docs list QuickBooks Sync by Acodei, a Stripe App built by a third party and embedded through Connect. It syncs sales, fees, payouts, refunds, invoices, customers, products and taxes, per transaction or as a daily total. We did not read Stripe's App Marketplace for this page, so we can't name the apps a single business can install there. A custom build on both APIs is the other route.

Why doesn't my Stripe payout match the bank deposit in QuickBooks?

Check the date first. Stripe's payout reconciliation report groups a payout by its estimated arrival date, not the day your bank posts it. Then look for money pulled back out. A dispute takes the disputed amount from your balance, and Stripe also debits a dispute fee. Instant payouts are the hardest case. Stripe can't say which transactions an instant payout holds, so you match those yourself.

Why are people leaving QuickBooks?

Volume is the limit a Stripe business may feel first, though we have no survey of reasons. Intuit's API limits page lets one transaction, journal entries aside, link to at most 10,000 others. So a payout holding more than 10,000 payments can't post as one linked deposit. The same page allows 500 requests a minute for each company, which sets the pace of a first import.

Do you need our live Stripe and QuickBooks accounts to build this?

No live data is needed at first. Stripe's sandbox has its own limit of 25 requests a second, and Intuit lets a developer hold up to 10 sandbox companies, each kept for two years. A build can run from test charge to test deposit before anyone touches your books. We sign your NDA before you share any data, if you ask.

Sources

Every source behind a figure or a vendor fact on this page, with the day we read it.

Plan your Stripe to QuickBooks sync

Send one recent Stripe payout report and tell us which QuickBooks edition you run. The first call is free.

Plan the Stripe payout sync