Help for owners
Customers pay through Square but my website does not show the order
Short answer
Square reports payments and orders to your site through notifications, and a customer returning from the checkout page is not proof they paid. Square retries a failed notification for up to 24 hours, then discards it. If your site does not acknowledge in time, miss duplicates or receive them out of order, orders go out of sync.
Does this sound like your situation?
- Square shows the payment but my website has no matching order.
- Customers see a thank you page but my system says unpaid.
- Stock on my site does not drop after a sale.
- Some orders sync and others never arrive.
- The same order appears twice in my system.
Why does this happen?
Returning to your site proves nothing
Square's Checkout API lets you set a redirect address for buyers after payment, otherwise it shows its own confirmation page. For bank transfers, which are asynchronous, Square states the redirect does not confirm payment, and you should wait for the payment status to become completed before fulfilling the order.
Confirmed by developer.squareup.com
Your site is told by notification
Square says applications can follow Orders API and Payments API notifications to track orders and payments. If your site never subscribed, subscribed to the wrong events, or uses a wrong URL, it learns nothing after the customer pays.
Confirmed by developer.squareup.com
A slow or failing reply loses the message
Square wants a 2xx reply as soon as possible and says your application has 10 seconds to respond. Without it Square retries with exponential backoff for up to 24 hours. After 24 hours without success the notification is discarded and not retried again.
Confirmed by developer.squareup.com
Repeats and wrong order are normal
Square says notifications can arrive more than once and delivery order is not promised. A site that creates a new order on every message produces duplicates, and one that expects creation before update misses changes.
Confirmed by developer.squareup.com
Orders come from everywhere
Square states any order for the connected account is visible to your application, whether made by Square, your own app or another developer's app. Your site may be pulling in or ignoring sales it was not designed for. Square also updates inventory only for orders built from catalogue items.
Confirmed by developer.squareup.com
What can I do about it today?
- Compare Square with your site for one dayPick a day and list the orders in both places. Note which are missing and what they have in common, such as payment type or time of day.
- Do not send goods on a thank you page aloneFor orders your site shows as unpaid, check them in Square first, then fulfil.
- Do not edit stock by hand in two placesPick one place as the truth until the sync is fixed. Editing both makes the gap harder to untangle.
- Ask whether notifications are set upYour developer can confirm that a notification URL exists in the Square developer console and that it points to the live site.
- Keep a list of what you fixed manuallyIt lets your developer reconcile later without double entries.
When should I bring someone in?
- Orders have been missing for more than a day, since Square stops retrying after 24 hours.
- Duplicates or missing stock are already affecting what customers receive.
- Nobody knows how the site and Square were connected.
How do I handle it?
- Trace one order throughI follow one real order from payment to the notification, to your server and into your database, and see where it stops.
- Make the receiver quick and safeIt acknowledges first, then processes. Each event ID is recorded so repeats do nothing, and ordering is not assumed.
- Recover what was missedSquare points to its Events API for recovering missed notifications, so I use it, and the orders list, to bring your site up to date.
- Agree one source of truthI write down which system holds stock and which holds orders, and how a change in one reaches the other, so the gap does not reopen.
The price depends on what I find, so I quote in writing after a short discovery call. Tell me what is happening and I reply within 24 hours.
What do owners ask about this?
How long does Square keep trying to deliver?
Square says it retries with exponential backoff for up to 24 hours after the event, then discards the notification.
Can missed orders be recovered?
Square points to its Events API for recovering missed notifications, and orders can also be read directly. I cannot promise a full recovery in every case.
Is this the same as my stock being wrong?
Partly. Stock problems have their own causes, covered on a separate page about Square orders and inventory not matching.
Sources
How was this page made?
I drafted this page with AI assistance from the official documents listed under Sources. Found a mistake? Tell me.