A storefront that knows what is actually in the warehouse
Headless commerce is worth the effort only if the head and the body share one truth about stock. Otherwise you have bought a faster way to oversell.
The site sells units already committed to a marketplace order.
Product data maintained in the storefront and the ERP, differently.
Marketplace orders arriving as files somebody imports by hand.
Refunds and fees that never reconcile to the payment settlement.
Catalogue
One product record with channel-specific attributes, pricing and media, published outward rather than maintained twice.
Checkout
Cart, tax, shipping and payment, with stock reserved at the moment of order rather than at the next export.
Marketplaces
Listing, availability and order synchronisation with the marketplaces you already sell on, as events not files.
Money
Orders, refunds, fees and settlements matched per day, with unmatched items as a work queue instead of a variance.
When you should not go headless
Headless is a means, not a goal. Three situations where a hosted platform is the better answer.
A standard catalogue and one channel
If a hosted platform fits your product model and you sell through one storefront, headless adds cost and no capability.
No engineering capacity
Headless means owning a codebase. Without someone to maintain it, a hosted platform serves you better.
Speed to launch matters most
If the priority is trading next month, launch hosted and revisit the architecture once the operation is known.
The real problem is upstream
If stock accuracy is the issue, a new storefront will not fix it. The warehouse comes first.
Why Medusa rather than a hosted platform?
Because the data model is open and extensible, so the storefront can read your real stock position rather than a synchronised copy. If you do not need that, you probably do not need Medusa.
Can it work with our existing ERP?
Yes. The integration layer is built as its own component, so the commerce side does not care which ERP sits behind it.
Who builds the front end?
Either your team or ours. Headless means the storefront is a separate application, which is exactly why the seam between it and the operation matters more than the framework.
How are marketplaces handled?
As channels with their own listing and availability rules, reading the same stock position, with orders arriving as events on the same order record.
What about the finance side?
We usually build the reconciliation report before the storefront integration, because it is the only thing that proves the integration is correct.
This page names a platform because that is what people search for. The capability page describes the work platform-independently.
ERP implementation checklist
The decisions that determine whether a rollout lands, most of which come before anyone configures anything. Readable in full, no email required.
Show us where your storefront and ledger disagree.
That gap is usually one interface and one ownership decision.