Square Online and your Facebook/Instagram Shop checkout URL: why the cart is empty, and how to fix it (2026)

By Draško Georgijev · Published 27 October 2026 · Last updated: 27 October 2026 · All articles

What changed: Meta moved Shop checkout to your website

Until 2025, a Facebook or Instagram Shop in the United States could take the whole order inside the app. Meta ended that. Its developer notice says Shops checkout "will no longer be available on Facebook and Instagram" and that buyers "will instead be sent to sellers' own websites for checkout", with the old flow retired on 4 September 2025 (Meta, Customer Communication).

That makes one thing mandatory for every Shop: a checkout URL on your own site. When a buyer taps Checkout, Meta opens that URL and appends the cart to it. Meta's spec (Set Up a Checkout URL) lists the parameters:

• products: the items and quantities as ID:quantity pairs separated by commas, for example 12345:3,23456:1.
• coupon: one optional promo code the buyer picked in the Shop.
• cart_origin: facebook, instagram or meta_shops, plus utm_source, utm_medium and fbclid for attribution.

Your page has to decode those values, look the IDs up in your catalog, put the items in the cart with the right quantities, apply the coupon and show the checkout. Meta checks this with a checkout-URL validation tool in Commerce Manager, which you must pass before the Shop goes live, and it re-reviews your checkout "on a periodic basis" afterwards (same page). Shopify (help article) and BigCommerce (their notice) publish how their stores receive that link.

Why Square Online opens an empty cart

Square Online's Meta integration syncs your items to Commerce Manager and lets you run ads and tag products (Square, Connect your online store with Meta for Business). What it does not have is a page that understands the products parameter. Whatever address you paste as the checkout URL, Square Online ignores the list Meta sends and shows the cart the buyer's browser already had, which on a first visit from Instagram is empty.

Sellers have been reporting this in the Square Community since July 2025. Paraphrased, with the threads linked so you can read them in full:

• Meta Commerce Manager & Checkout URL (opened 29 July 2025): Meta rejected every Square checkout link with "potential issues with your checkout URL"; Square suggested linking the cart page instead, which the seller reported also failed, and Square's moderator noted limited ability to troubleshoot a Meta product. The thread was marked solved while the problem was still open.
• Meta Commerce Changes and New checkout requirement (opened 12 August 2025): Square's accepted answer was to link each Meta product to its Square item page. Later replies report that this fails the validator because the URL must accept product IDs and coupons, that developers quoted $1,500 to $5,000 for a custom fix, and that a third-party app appeared in July 2026. No fix from Square as of 27 October 2026.
• Need help with the integration between square online and Meta (2023 onwards): older problems with the same integration, where Square staff said they could not support the integration beyond connecting and disconnecting it.

The two popular workarounds fail for the same reason. A cart-page link opens the cart Square already knows about, not the one in the URL. An item-page link opens one product, so Meta's test, which sends at least two products and optionally a coupon, cannot find the second item. A Square payment link (the "Buy now" links from Square Online Checkout) sells a fixed item set and ignores the parameters too.

How to check if you're affected

1. Open Commerce Manager, then your Shop's settings. If the checkout section shows a warning about your checkout URL, or the Shop is marked as hidden or not visible because checkout is not set up, you are affected.

   Screenshot coming: Commerce Manager Shop settings with the checkout-URL warning

2. Run the checkout-URL test in Commerce Manager. It opens your URL with two products and a coupon. If the page that opens shows an empty cart, one product, or the wrong quantities, the test fails.

   Screenshot coming: Meta's checkout-URL test result showing a failed check

3. Look at the item IDs in your Meta catalog. Items synced from Square carry Square's 24-character variation IDs. Those are the IDs Meta puts into products=, and the page that opens must be able to turn them back into cart lines.

   Screenshot coming: A catalog item in Commerce Manager showing its 24-character Square ID

4. Try it yourself: take your checkout URL and add ?products=<ID>:2 with a real ID from the catalog. Open it in a private window on your phone. If the cart is empty, Meta's buyers see the same.

Your options, compared honestly

There are four ways out. None is wrong; they trade money, effort and what you keep.

1. Hide the Shop and keep the catalog

Your Meta catalog does not need a Shop to be useful. Catalog ads and product tags can link to your Square Online product pages, where checkout works. You lose the Shop tab and in-app browsing, and buyers add to cart on your site instead. Costs nothing, takes an hour, and it is the right choice if the Shop brought few orders before 2025.

2. A third-party checkout bridge

A bridge is a small service on its own address that reads Meta's link, creates the matching Square checkout with the right items and sends the buyer there. One is available today: Appaloosa Tools, listed at about $15 a month with a paid setup option when we checked on 27 October 2026; a seller in the Square thread reported it working for them. We are building one too, and it is in development: founding sellers pay nothing until it works for their shop.

3. Do it yourself with Square's Checkout API

If you or your developer are comfortable with APIs, Square's Checkout API can create a hosted checkout for any set of items (CreatePaymentLink). The pattern is a tiny web app: read products, call the API with those variations and quantities, redirect the buyer to the returned URL. Three gotchas we found in the documentation (checkout options):

• Shipping is a flat fee. checkout_options.shipping_fee takes one name and one amount per link; rate-by-address or weight-based shipping is up to you.
• Orders need finishing. The order moves to OPEN when the buyer pays; your staff completes it in Square like any other online order.
• No coupon-code parameter. The hosted page shows a box for Square Marketing coupons, but there is no field to pass the code from Meta's link, so you either apply the discount as a line item yourself or accept that the Shop coupon will not carry over.

4. Move to a platform that reads Meta's link natively

If the Shop matters more than the Square Online site, moving removes the problem instead of bridging it. SpreadFront keeps your whole catalog in one Google Sheet, publishes it to Meta, and receives the checkout link into its own cart, with whatever payment method your store uses, including card checkout through your own Stripe or PayPal, bank transfer or cash on delivery. Shopify documents the same flow for its stores (link above). Check the plan prices on each site before you decide; they change.

What to ask any vendor before paying

• "Show me a passed Meta test URL with two products and a coupon", on a Square Online store, not a demo on another platform.
• "How is my shipping fee handled?" Flat fee, free over a threshold, or rates by address? Ask what the buyer sees.
• "What happens to the coupon the buyer picked in the Shop?" Applied automatically, typed by the buyer, or dropped?
• "What happens at Meta's periodic re-review?" Meta re-checks checkouts without warning; ask who gets notified and what the fix path is.
• "Where do orders and money land?" They should land in your Square account, with the vendor never touching card data.

FAQ

Last updated: 27 October 2026. Facts about Meta and Square link to their own pages; if something changed since, tell us and we will correct it. Square and Square Online are trademarks of Block, Inc. SpreadFront is not affiliated with or endorsed by Block or Meta.