The Wix headless checkout trap nobody warns you about

Every Wix headless tutorial starts with the same hook: render your products in any frontend you want. They show you the Stores REST API, the new OAuth flow, a Next.js sample. They never mention that the moment your customer clicks Buy now, you have to send them somewhere outside the storefront you just built.

The clause

Section 4 of the Wix Headless Terms of Service: payment processing for Wix Stores is performed by Wix or its partners, and third parties may not implement custom checkout flows that bypass Wix's payment infrastructure. The Stores API exposes a createCheckout call that returns a hosted URL. That URL — and nothing else — is your checkout.

What this means in practice

• Your beautiful custom cart UI works.
• Your beautiful custom product detail page works.
• Your beautiful custom checkout form does not. Clicking "Pay" must redirect to https://www.wix.com/checkout/{checkoutId}.
• Post-purchase upsells inside the checkout flow — not possible.
• Custom payment processors — not possible. Wix decides which processors are available.
• Pre-filling customer data into checkout — partial, via query params; full programmatic control is not available.

The four-step workaround

You can't build a custom checkout, but you can soften the handoff so it feels like part of your store:

1. Brand the checkout in Wix dashboard. Wix lets you customize the checkout colors, logo, and basic typography from the Stores admin. Match your storefront — same logo, same colors, similar font.
2. Use the cart catalog reference correctly. When you POST to /cart/items, include thecatalogReference with Wix's Stores app ID (1380b703-ce81-ff05-f115-39571d94dfcd). Skip this and the hosted checkout will reject the cart.
3. Pre-populate the customer email. If the customer is already authenticated in your storefront, pass their email as a query param to the checkout URL — Wix accepts it. Reduces the perceived "is this a new site?" friction.
4. Redirect back to a thank-you page on your domain. Wix lets you configure a custom return URL in the Stores settings. Use this to send the customer back to /order-confirmation on your storefront after a successful payment, so the journey ends where it started.

What about Shopify? Or BigCommerce?

Shopify has the same constraint at the standard tier — checkout is locked. Shopify Plus ($2000/mo+) unlocks Checkout Extensibility, which gives you genuine programmatic control. BigCommerce gives you a Stencil-based or fully custom checkout on every tier. Webflow Ecommerce — locked, similar to Wix.

If full checkout customization is a real requirement, your platform shortlist starts with Shopify Plus or BigCommerce. If you're on Wix and the redirect bothers you, the only escape route is migrating platforms — a project that costs more than most teams expect.

Why this is OK for 95% of stores

Customers care less about a redirect than designers do. The data from PayPal, Stripe, and Shopify itself is consistent: a well-branded, fast, trusted hosted checkout converts as well as a "stay-on-site" custom one for the vast majority of stores. The exceptions are very high-AOV businesses (jewelry, furniture, luxury) where the checkout itself is a brand moment, and B2B flows that need quote-to-cart-to-PO conversion.

If you're neither of those — and most stores aren't — Wix's hosted checkout is a non-issue. The trap is not the checkout itself; the trap is finding out about the limitation three months into a headless rebuild, after you've promised a stakeholder it would be possible.