How Square Sync Works
What syncs in each direction, how fast, and how Square fees, refunds and stock are handled
Sync runs on its own — you rarely need to touch it
Once your Square account is connected and its locations are mapped, Square tells Ardent Seller when an order, payment or refund changes, and Ardent Seller runs a sales sync for that account shortly after, so completed sales and refunds usually arrive within a minute or two of Square recording them. A payment taken in Square's offline mode reaches Square, and then Ardent Seller, only after your device reconnects. A scheduled sales sync still runs every 15 minutes as a safety net: anything Square doesn't report, or that comes in while a sync is already running, arrives with it. New processing fees come in about every 15 minutes, once Square reports them. Ardent Seller refreshes your items every 6 hours and, for listings set to auto push, sends stock counts back to each mapped Square location whenever your inventory changes. A daily reconciliation double-checks that both sides agree. Automatic syncing starts after your first sync finishes, and pauses while a connection is paused or disconnected.
What syncs, and in which direction
| Data | Direction | When |
|---|---|---|
| Completed sales | Square to Ardent Seller | Usually within a minute or two of Square recording the sale, with a scheduled sync every 15 minutes as a safety net |
| Refunds | Square to Ardent Seller | Usually within a minute or two, with the sales sync — a full refund marks the sale returned, a partial refund is booked by amount |
| Payment processing fees | Square to Ardent Seller | About every 15 minutes, once Square reports each fee — booked as an expense on the Ledger tab |
| Items and variations | Square to Ardent Seller | Automatically every 6 hours |
| Square locations | Square to Ardent Seller | With the first sync, or on demand from the Locations tab |
| Stock count, per location | Ardent Seller to Square | For auto push listings, when a linked item’s stock changes at a mapped location — production, other channels’ sales, transfers, stocktakes |
A completed Square sale from any of your Square locations, whether rung up on the register or placed through Square Online, becomes a regular sale transaction named after its Square receipt number ("Square sale #…"), with each line matched to the linked inventory item and discounts and tax recorded. Tips and service charges come in as lines of their own, so the lines add up to what the customer paid. A gift card sold is left out of the sale, since it is money owed to the buyer until they spend it, and an order that only sold gift cards does not import; a purchase paid with a gift card imports as a normal sale. So when an order included a gift card, the imported sale total can be lower than Square's receipt total. The sale is recorded at the Ardent Seller location mapped to the Square location where it was rung up, so it moves stock and feeds your reports like any other sale (see How Stock Moves). Lines with no linked item, such as custom amounts, keep their revenue but deduct no stock; find them with the Sales tab's Needs attention filter. Once you link an unlinked item to an existing product on the Listings tab with syncing on, its earlier sales deduct stock straight away (if there are a great many, the rest link overnight); with syncing off, they are relinked when you turn it back on. If you already adjusted stock by hand for those sales, reverse that adjustment first, or they are deducted twice. An item you turn into a new product with Create product relinks nothing: the new product starts from the stock Square reports, which already reflects those sales. Custom amounts have no item to link, so adjust their stock by hand.
The customer on a Square sale is matched or created when the sale carries a Square customer; otherwise, including a sale that carries only a payment email, it goes to the connection's walk-in customer. A customer created this way shows the Square customer id it was made for under Marketplace buyer on its sheet (for example "Marketplace buyer #ABC123"), kept so that buyer's next sales match it, and its History says it was created automatically from a Square order.
What does not sync
- Open orders. Only completed sales import. An online order that is paid but still open in Square arrives once it is completed.
- Payouts. Square's processing fees are imported (see below), but your deposits and payout statements are not.
- Items, prices, descriptions and photos. Items flow one way, from Square into Ardent Seller, without their images. Ardent Seller only ever writes stock counts to Square; it never creates or edits an item in your Square catalog.
- Listing views. Square does not report how often an item is viewed, so there are no view analytics for a Square connection.
- Sales tax collected through Square is recorded on the sale, but Ardent Seller does not file or remit it.
Square fees and Schedule C
Square charges a payment processing fee on card payments, and reports it a little while after the payment, usually within minutes. Ardent Seller picks each fee up on the next sync once Square reports it and lists it on the connection's Ledger tab. Each fee is booked as an expense named "Square payment processing fee", dated the day of the payment, filed under the IRS Schedule C Commissions and Fees category (line 10), and linked to its sale once that sale is in Ardent Seller; a fee that arrives first is linked when its sale is imported, and any fee still unlinked after that is caught by the daily reconciliation (below) and linked then. A fee linked to a sale is booked at the same location as that sale. Cash sales carry no fee, so they have no ledger entry.
When a refund changes a fee, Square reports an adjustment, which arrives the same way as its own ledger entry ("Square payment processing fee credit" when it is money back to you). A fee that has not appeared yet is not lost: Ardent Seller keeps looking back over recent payments for fees Square settles late. To check now rather than wait, run Sync Ledger from the connection's Sync Options. The fees then show up in your Schedule C and profit reports (see the Measure guide) like any other expense.
Refunds
Refunds you give in Square usually come through within a minute or two, or with the next scheduled sales sync if Square doesn't report them. A full refund marks the imported sale as returned. A partial refund is booked as a partial refund adjustment for exactly the amount Square refunded, described by the sale's receipt number (or ticket name), for example "Partial refund on Square sale #4ZtF", and a second partial refund on the same sale adds only the new amount. If the rest of the sale is refunded later, the sale is marked returned and its earlier partial refund adjustments are canceled, since the returned sale already covers them; the audit trail notes why. Ardent Seller never issues a refund itself; refunds always start in Square. If you delete an imported sale, its partial refund adjustments are deleted with it, and its Square fees are kept but no longer linked to it, unless you select them for deletion too; the delete dialog says so, and the audit trail records each change.
Orders from before your import window. If you refund an order paid before the import window you chose when you connected Square, Ardent Seller doesn't import that order just to book its refund: it was never in your records, and importing it would add a sale to a period you may have already closed. The store's Sync log names the order instead, says whether it was refunded or partly refunded (with the amount when known), and gives the date your import window starts. If your books include that order, run Backfill History over a range that includes it, which imports the order and books its refund together, or record it by hand: a full refund as a sale with the Returned status (see recording sales in the Deliver guide), a partial refund as an adjustment for the amount. If the buyer sent items back, also add an adjustment under Optimize > Adjustments to put them back in stock.
Orders that included a gift card. Ardent Seller doesn't count a gift card you sell as sales income, so on such an order only the part of a partial refund that paid back items is booked, and refunding just the gift card books nothing. When Square doesn't say which items a refund covered (you refunded an amount rather than choosing items), Ardent Seller holds the refund instead of guessing, and Ardent Seller support books the items' share for you.
Stock per location
Square holds a count for every item variation at every location, and Ardent Seller pushes to each mapped location separately. When a production run finishes at your workshop, the workshop's Square location goes up; when you move stock to a market location, that location's count follows. The push sends the on-hand quantity at the mapped Ardent Seller location minus your Safety Buffer, a per-connection reserve that protects you from overselling. Locations you have not mapped, or switched off on the Locations tab, are never written to.
Automatic pushes only reach listings set to Auto push. Newly linked listings start on Manual only, which leaves your Square counts alone until you push by hand. Change the default for the connection, and optionally every listing already linked, in the connection's Settings, or switch one listing in its details. The same product sold through Square and listed on Etsy or Shopify shares one inventory item: a sale imported from one channel is passed on to the others' auto push listings as soon as it imports, so a Square sale usually lowers your Etsy or Shopify quantity within a few minutes, and an Etsy sale lowers your Square count within about 15 minutes (Etsy orders arrive on a 15-minute schedule); the safety buffer covers anything that sells in between.
Manual sync controls
You don't need to run syncs by hand, but you can. Open your connection from Settings → Integrations (open Integrations) to find:
- "Sync All" — runs every sync type now (available while the connection is active).
- "Sync Options" — a dropdown to run one type: "Sync Listings", "Sync Sales", "Sync Ledger", or "Push Inventory".
- "Backfill History" — imports older sales beyond your first sync's import window.
- "Refresh from store" on the Locations tab — pulls the location list again after you add or rename locations in Square.
- "Pause Sync" and "Resume Sync" — stop and restart all automatic syncing without disconnecting.
Manual syncs run in the background and may take a few minutes; the last-sync cards on the connection page show when each type last ran.
When you reach your transaction limit
Imported sales count toward your plan's monthly transaction limit. If a sales sync would exceed it, the extra sales are queued, not lost; they import automatically when capacity is available, or sooner if you upgrade. Historical backfills cap themselves at 75% of your monthly limit to leave room for manual transactions. See Billing & Plans for how limits work on each plan.
Daily reconciliation
Every day at 02:00 UTC, Ardent Seller compares the count it expects for each linked variation at each mapped location against the count Square actually holds, and records any difference in the sync log with a reason. Reconciliation also recovers sales the regular sync missed by queueing them automatically.
If a linked Square item was deleted in Square, reconciliation confirms it is gone, turns off syncing for it (it shows as Inactive under Listings, with "Removed from store" in the Platform State column) and notes it in the sync log. The Ardent Seller item it was linked to and its past sales are unchanged. You can't use "Activate Syncing" on a removed item: if you recreated it in Square, find its new listing in the Listings tab and link the Ardent Seller item from that row. If the item is back in Square, run "Sync Listings" from the connection's "Sync Options" menu first; once the Platform State column no longer says "Removed from store", you can turn syncing back on.
It also links any Square processing fee that arrived before its sale and was missed when the sale was imported, filing the fee under that sale's location. The fee's history shows the change, made by Ardent Seller.
Small gaps caused by sync timing clear on their own within a day and never need action. A difference that persists usually means a count was changed directly in Square; the sync log entry names the item and location so you can decide which side is right.
Troubleshooting
| What you see | What to check |
|---|---|
| A sale I just rang up is not in Ardent Seller yet | Sales usually arrive within a minute or two, and otherwise with the next scheduled sync (every 15 minutes), but only once Square has the completed order: a payment taken in Square’s offline mode arrives after your device reconnects. Run Sync Sales from Sync Options to check now. |
| A sale imported but no stock came off | The line was a custom amount, or its Square item is not linked yet. Filter the Sales tab to Needs attention, then link the item on the Listings tab (or adjust stock by hand for a custom amount). |
| A sale total is lower than Square’s, or a Square sale is missing | Check whether the order included a gift card. A gift card sold is left out of the sale, since it is owed to the buyer until spent, and an order that only sold gift cards does not import. A purchase paid with a gift card imports as a normal sale. |
| A partial refund on a Square order with a gift card isn’t on the sale | Only the part of the refund that paid back items is booked, so refunding just the gift card books nothing. If you refunded an amount rather than choosing items, Square doesn’t say which items it covered, so Ardent Seller holds the refund and Ardent Seller support books the items’ share. |
| A card sale has no fee on the Ledger tab | Square reports the fee a little after the payment. Wait for the next sync or run Sync Ledger. Cash sales never carry a fee. |
| A sale landed at the wrong location | Check the Locations tab: the Square location it was rung up at may be unmapped or switched off, in which case it goes to the fallback mapping or the connection’s default location. |
| Square counts are not changing when my stock changes | The listing may be on Manual only (switch it to Auto push in its details or the connection’s Settings), the item may not be linked, or its Square location may be unmapped or switched off. |
| Register sales are all under one customer | That is the walk-in customer, used for sales with no customer attached. Pick a different one, or None, under Walk-in customer in the connection’s Settings. |
| The connection shows Needs Reconnect | Ardent Seller can no longer reach your Square account: its access ended or was removed in Square. Click Reconnect and approve again on Square, signed in as the same Square account; your links, mappings and settings are kept. If you removed access on purpose, choose Disconnect Shop from the More actions menu instead. |
The connection's Sync Log tab records each sync that found new data or hit an error, with a status of Success, Partial, Failed or Skipped. Repeated failures pause syncing for a while on their own. A connection whose Square access has ended, or was removed in Square, shows Needs Reconnect and a Reconnect button, and the account's owners and managers get an email naming the shop and the Ardent Seller account (at most one a day per connection); when Square reports the removal, the Sync Log also records it.
The term “Square” is a trademark of Block, Inc. This application uses the Square API but is not endorsed or certified by Block, Inc.
Related articles
Connect Your Square Account
Connect a Square account to Ardent Seller — approving access on Square, running the first sync, mapping Square locations to your locations, linking items to inventory, the walk-in customer and custom-amount sales, and how disconnect and reconnect work.
How Shopify Sync Works
Shopify sync in Ardent Seller: orders and refunds usually in a minute or two, product edits within minutes, stock pushed per location, daily reconciliation.
Billing & Plans
Every Ardent Seller plan compared — prices, transaction limits, users, locations, and storage — plus how Pay As You Go credits, annual billing, signup bonuses, and plan changes work.