- Home
- QuickBooks integration
- WooCommerce and QuickBooks
WooCommerce to QuickBooks: post the order when it is paid, not when it is placed
A QuickBooks WooCommerce integration should post an order to QuickBooks Online once WooCommerce marks it paid. For most orders that is the processing status. An order whose items are all virtual and downloadable can skip processing and go from pending payment straight to completed. Refunds need a check of their own, because a manual refund can mark an order refunded while the money stays put.
Post on processing, when WooCommerce marks the order paid
Only some WooCommerce statuses mean money arrived. The REST API lists eight: pending, processing, on-hold, completed, cancelled, refunded, failed and trash. New orders start as pending. WooCommerce says every order needs processing except one whose products are all virtual and downloadable. Those can move from pending payment straight to completed once paid.
Scroll the table sideways to see every column.
| WooCommerce status | What WooCommerce’s docs say | What QuickBooks Online gets |
|---|---|---|
| Pending payment | The order was received, but no payment has been made | Nothing yet |
| On hold | Stock is reduced, but payment still needs confirming, as with a BACS bank transfer | Nothing until payment is confirmed |
| Processing | Payment received, stock reduced, order waiting to ship | A sales receipt, since Intuit uses one when the customer pays at the time of sale |
| Completed | The order was fulfilled and needs no further action | A sales receipt if the order skipped processing (all items virtual and downloadable); otherwise no new record |
| Refunded | Fully refunded by a shop manager | A refund receipt, once the money has gone back |
| Failed | The payment failed or was declined, so nothing was paid | Nothing |
| Cancelled | An admin or the customer cancelled it, and it may need a refund | A refund receipt only if money was taken and returned |
Orders taken on account need their own rule. Intuit’s guide says to send an invoice when customers will pay in the future. If your store lets trade buyers order without paying, post those orders as invoices when they are placed. When they later reach processing, record the payment against that invoice instead of adding a sales receipt.
Drafts never reach the books. WooCommerce deletes inactive draft orders in a daily cleanup.
The order fields that matter for the books
WooCommerce’s order record carries what QuickBooks needs, if the sync reads the right fields:
- date_paid. The date the order was paid, in the store’s time zone. Use it as the QuickBooks transaction date, not the date the order was created.
- transaction_id. The payment’s unique ID from the gateway. Store it on the QuickBooks record, so a payout can be matched back to each order later.
- customer_id. This is 0 for guest orders, so pick a rule for them: one shared web customer, or one QuickBooks customer per email address.
- created_via. Where the order came from. It is set when the order is made and cannot change afterwards, so it is a safe way to route admin-entered orders differently.
- prices_include_tax. True when the prices included tax at checkout. Intuit’s sales tax page says US transaction lines in QuickBooks are always tax exclusive, so the sync splits the tax out before it sends line prices.
Intuit adds one rule for the customer and the item. Records a sale points to can’t be created inside that sale. So the sync creates the customer and the product first, then the sales receipt.
Tax lines arrive already worked out
WooCommerce keeps one tax line per tax rate on each order, with the rate’s code and label. It marks compound rates and keeps shipping tax apart from the rest. QuickBooks Online in the US may want to work the tax out again. Intuit’s docs say US companies made after November 10, 2017 use automated sales tax. Intuit also says those companies honor a total tax amount the app sends, so send WooCommerce’s figure and the books match what the customer paid.
A refund in WooCommerce may not mean money moved
Read the refund’s refunded_payment flag before booking anything. It is read-only, and it shows whether the money went back through the payment gateway’s API.
Two other settings, api_refund and api_restock, are write-only. They apply only when an app creates the refund through the REST API, and both default to true. Then the gateway’s API makes the refund, and the refunded items return to stock. A refund made by hand in WP Admin tells the sync nothing through them.
Two more traps sit in WooCommerce’s docs:
- Manual refunds. WooCommerce’s order status guide says a Manual Refund can set an order to Refunded without returning the customer’s funds.
- Amounts that disagree. A refund amount, when given, overrides the line totals, even when they don’t add up to it. The refund receipt should follow the amount and flag the gap for a person.
So a refund receipt in QuickBooks waits for proof the money left.
WooCommerce disables a webhook after six failures in a row
A webhook is a message WooCommerce sends when something changes. Orders have three topics: order.created, order.updated and order.deleted. WooCommerce’s help page also lists topics for coupons, customers, products and one called Action. Each delivery names its topic in an X-WC-Webhook-Topic header, and a secret key signs it, so the receiver can check it came from your store.
The failure rule is strict. WooCommerce disables a webhook after more than five failures in a row, and its help page lists Disabled as the status that stops delivery due to failures. A failure is any answer other than a 2xx, 301 or 302 status. So a short outage on the receiving server can switch the sync off until someone sets the webhook back to Active. A developer can raise or lower that threshold with the woocommerce_max_webhook_delivery_failures filter.
Two habits keep a sync safe:
- Listen to order.updated and read the status. The order topics hold no separate paid event, so the sync acts when an update shows the order reached processing, or reached completed without passing through processing.
- Run a daily catch-up. Read recent orders from the REST API and post any that were missed. List calls return 10 items a page by default, so page through the results.
One old trap remains on long-running stores. WooCommerce removed the legacy REST API from its core. Webhooks built on it stop working unless the Legacy REST API plugin is installed. Use version v3 of the REST API for new work.
WooPayments sends a payout summary you can match
WooPayments names Stripe as its payments partner. Since July 2026, WooPayments emails a notice whenever a payout is scheduled. The notice holds up to four items: sales, refunds, fees and adjustments, and the payout total. The payout total is what settles in your bank after refunds and fees.
The fees line needs care. WooPayments says Fees and adjustments is the net of all other deductions and credits in the payout, including processing fees and dispute fees. The same line can include Stripe Capital loan repayments. A loan repayment is not a fee, so book it to the loan, apart from sales and fees. WooPayments also says that once a payout is scheduled, its funds can’t be used for anything else, such as refunds. Our QuickBooks Stripe integration page covers how a payout becomes a QuickBooks deposit.
Stores that take payments through Intuit instead can use the Intuit Payments Gateway plugin. Its listing says Intuit Payments accounts are only for merchants in the US, and it accepts eChecks. Intuit’s payments guide says QuickBooks Online creates the deposit itself when the app sets the sales receipt up for automatic reconciliation and stores the charge’s CCTransId. Check whether the plugin does that before you rely on it.
Stock rules come from QuickBooks, not WooCommerce
WooCommerce reduces stock when an order is paid, and also when it goes on hold. Its API notes that marking an order paid sets it to processing and reduces stock. QuickBooks keeps its own count, with its own rules:
- QuickBooks has four item types, from inventory and non-inventory items to services and bundles.
- QuickBooks Online costs stock first in, first out.
- Some versions of QuickBooks Online do not support inventory at all.
Decide which system owns the stock count before the build starts. Running both as the master leads to two numbers for the same shelf.
Ready-made plugins differ more than their names
We read two QuickBooks plugin listings in the WooCommerce Marketplace on 18 November 2026. Our fetch of the marketplace search page returned nothing, so we give no count of plugins.
Scroll the table sideways to see every column.
| Plugin | Active installs shown | QuickBooks products | Sync direction and record types |
|---|---|---|---|
| QuickBooks Sync for WooCommerce, by MyWorks | 10K+ | Online, Desktop and POS | Orders as an invoice, sales receipt, sales order or estimate, as often as every 5 minutes; needs a free or paid MyWorks account |
| QuickBooks Integration for WooCommerce, by WP Swings | 300+ | Online only | One way, WooCommerce to QuickBooks; syncs refund details when an order turns refunded |
A custom build makes sense when your rules sit outside both, such as refunds that need a person’s check. Order storage is less of a worry with Marketplace plugins. Before version 8.2, WooCommerce kept orders in the WordPress posts tables. WooCommerce says every extension on WooCommerce.com works with its newer order tables, and it blocks the switch while an incompatible extension from outside the Marketplace is in use.
The REST API needs WooCommerce 3.5 and pretty permalinks
The WooCommerce REST API needs WooCommerce 3.5 or later, and pretty permalinks turned on in WordPress. Each set of API keys is linked to a WordPress user, and the consumer secret is shown only once. Save it in a password manager the moment it appears.
A manual refund is the case for an agent
A manual refund can leave a QuickBooks refund with no money behind it. A custom agent can watch for orders that turn Refunded with refunded_payment false, check the gateway’s own record for a refund, and hold the refund receipt as a draft until a person confirms the money left. See QuickBooks AI agents for the agent side.
Order sync and invoicing in QuickBooks are jobs we have done
In QuickBooks, our team has run order sync and invoicing, along with bookkeeping and inventory sync. Other routes into QuickBooks are compared on our QuickBooks integration page.
Questions
What systems integrate with QuickBooks from WooCommerce?
Ready-made plugins and custom builds. In the WooCommerce Marketplace on 18 November 2026, QuickBooks Sync for WooCommerce by MyWorks showed 10K+ active installs and works with QuickBooks Online, Desktop and POS. QuickBooks Integration for WooCommerce by WP Swings showed 300+ installs, works only with QuickBooks Online and syncs one way. A custom build uses the WooCommerce REST API and Intuit's API.
Which WooCommerce orders should go into QuickBooks?
Orders that are paid. WooCommerce marks an order processing once payment is received and stock is reduced, so post a sales receipt then. An order whose items are all virtual and downloadable can go straight from pending payment to completed, so post those at completed. Pending payment means no payment yet. On hold means stock is reduced but payment still needs confirming.
Can the sync handle WooCommerce refunds?
Yes, with one check first. WooCommerce's refund record has a read-only refunded_payment flag that shows whether the money went back through the payment gateway's API. WooCommerce's docs also say a manual refund can set an order to Refunded without returning the customer's funds. So the sync books a refund receipt only when the money moved, or when your team confirms it.
Will QuickBooks keep the sales tax WooCommerce charged?
It can. Each WooCommerce order carries one tax line per tax rate, marks compound rates and keeps shipping tax apart. Its prices_include_tax flag says whether the prices already held tax at checkout. On the QuickBooks side, US companies made after November 10, 2017 use Intuit's automated sales tax. Intuit says those companies honor a total tax amount the app sends, so the books can match what the customer paid.
Why are people leaving QuickBooks?
Stock is where a store may feel QuickBooks' limits first, though we have no count of reasons. Intuit's docs say some versions of QuickBooks Online do not support inventory at all, and QuickBooks Online costs stock first in, first out. Check your plan before you plan a stock sync. Our team has moved companies off QuickBooks, Xero or Sage into a full ERP.
Do you need our live store and books to build this?
Not until go-live. WooCommerce ties each set of REST API keys to one WordPress user, so you can make a user just for the sync and remove it later. The consumer secret is shown only once, so whoever creates the keys should store it straight away. 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.
- WooCommerce REST API documentationRead 18 Nov 2026
- WooCommerce REST API documentation, webhooksRead 18 Nov 2026
- WooCommerce, order statusesRead 18 Nov 2026
- WooCommerce, webhooksRead 18 Nov 2026
- WooCommerce, REST API (help page)Read 18 Nov 2026
- WooCommerce developer docs, REST APIRead 18 Nov 2026
- WooCommerce, high-performance order storageRead 18 Nov 2026
- WooPayments, payoutsRead 18 Nov 2026
- WooCommerce Marketplace, QuickBooks Sync for WooCommerceRead 18 Nov 2026
- WooCommerce Marketplace, QuickBooks Integration for WooCommerceRead 18 Nov 2026
- WooCommerce Marketplace, Intuit Payments GatewayRead 18 Nov 2026
- Intuit Developer, process a payment (QuickBooks Payments)Read 18 Nov 2026
- Intuit Developer, invoicing basicsRead 18 Nov 2026
- Intuit Developer, basic inventory implementationRead 18 Nov 2026
- Intuit Developer, automated sales tax (US locales)Read 18 Nov 2026
- Intuit Developer, basic bookkeeping: inventoryRead 18 Nov 2026
- Intuit Developer, manage inventoryRead 18 Nov 2026
Set the posting rules for your store
List your payment gateways and say who issues refunds today. The first call is free.