{"id":1614,"date":"2024-07-10T12:42:47","date_gmt":"2024-07-10T10:42:47","guid":{"rendered":"https:\/\/spree.workdev.pl\/?page_id=1614"},"modified":"2026-04-23T12:11:01","modified_gmt":"2026-04-23T12:11:01","slug":"headless-ecommerce","status":"publish","type":"page","link":"https:\/\/spreecommerce.org\/headless-ecommerce\/","title":{"rendered":"Headless eCommerce"},"content":{"rendered":"\r\n
\r\n
\r\n
\r\n

Open Source Headless eCommerce Platform<\/p>\r\n

Open Source Headless eCommerce Platform<\/h1>\n

Connect any frontend to a complete REST API. Build storefronts, B2B portals, marketplaces, and mobile apps on one commerce backend. No GraphQL lock-in. No platform fees.<\/p>\n <\/div>\r\n

\r\n Get started<\/a>\r\n See a Demo<\/a>\r\n <\/div>\r\n \r\n \r\n <\/div>\r\n <\/section>\r\n\r\n\n\n\r\n
\r\n\r\n

Used by over 5K businesses worldwide<\/p>\r\n\r\n

\r\n
\r\n \r\n
\r\n
\r\n \"\"\r\n <\/div>\r\n
\r\n \"\"\r\n <\/div>\r\n
\r\n \"\"\r\n <\/div>\r\n
\r\n \"\"\r\n <\/div>\r\n
\r\n \"\"\r\n <\/div>\r\n
\r\n \"\"\r\n <\/div>\r\n
\r\n \"\"\r\n <\/div>\r\n
\r\n \"\"\r\n <\/div>\r\n
\r\n \"\"\r\n <\/div>\r\n
\r\n \"\"\r\n <\/div>\r\n
\r\n \"\"\r\n <\/div>\r\n
\r\n \"\"\r\n <\/div>\r\n <\/div>\r\n <\/div>\r\n <\/div>\r\n\r\n <\/section>\r\n\r\n\r\n\n\n\r\n
\r\n
\r\n\t\t\t
\r\n\t\t\t\t

Problem statement<\/p>\n

Finding a headless ecommerce platform with everything built in isn’t easy<\/p>\n\t\t\t<\/div>\r\n \t\t\t

\r\n \t\t\t\t
\r\n\t\t\t\t\t
\r\n \"\"\r\n <\/div>\r\n\t\t\t\t\t

Feature gaps<\/p>\r\n\t\t\t\t\t

Most headless ecommerce platforms ship a checkout and stop. You still need to build B2B pricing, marketplace payouts, and multi-store from scratch.<\/p>\r\n\t\t\t\t<\/div>\r\n \t\t\t\t

\r\n\t\t\t\t\t
\r\n \"\"\r\n <\/div>\r\n\t\t\t\t\t

Poor API documentation<\/p>\r\n\t\t\t\t\t

Endpoints without OpenAPI specs, no SDK, no code samples. Developers waste weeks reverse-engineering the API before writing a single line of storefront code.<\/p>\r\n\t\t\t\t<\/div>\r\n \t\t\t\t

\r\n\t\t\t\t\t
\r\n \"\"\r\n <\/div>\r\n\t\t\t\t\t

No developer tooling<\/p>\r\n\t\t\t\t\t

No CLI to scaffold projects, no starter kits, no AI coding assistance. Getting started means stitching together boilerplate from scratch.<\/p>\r\n\t\t\t\t<\/div>\r\n \t\t\t<\/div>\r\n \t\t<\/div>\r\n <\/section>\r\n\r\n\n\n\n

Spree has been built API-first and comes with full service support<\/p>\n\n\n\r\n

\r\n
\r\n
\r\n

Open Source eCommerce API<\/h3>\n

A production-grade REST API with full OpenAPI 3.0 specs you can import into Postman in seconds. Flat JSON responses, no GraphQL required. Payment Sessions API for Stripe, Adyen, and any PSP. TypeScript SDK with autocomplete and type safety for every endpoint.<\/p>\n

\r\n REST API docs<\/a>\r\n <\/div>\r\n <\/div>\r\n
\r\n \"\"\r\n <\/div>\r\n <\/div>\r\n <\/section>\r\n\r\n\n\n\r\n
\r\n
\r\n
\r\n

eCommerce SDK and Developer Tooling<\/h3>\n

Official TypeScript SDK and CLI to scaffold new projects in one command. Production-grade Next.js 16 starter with React 19, TypeScript 5, and Tailwind CSS 4. Spree ships AGENTS.md and a dedicated MCP server for documentation, so AI coding assistants like Claude and Cursor build on actual architecture, not hallucinated endpoints.<\/p>\n

\r\n Developer quickstart<\/a>\r\n <\/div>\r\n <\/div>\r\n
\r\n \"\"\r\n <\/div>\r\n <\/div>\r\n <\/section>\r\n\r\n\n\n\r\n
\r\n
\r\n
\r\n

Agentic Commerce Ready<\/h3>\n

Spree’s REST APIs are natively compatible with emerging agentic commerce protocols: OpenAI ACP, Google UCP, Anthropic MCP, and Visa TAP. All operate over HTTP\/REST, so AI purchasing agents can discover products, manage carts, and complete checkout programmatically. Build AI-powered storefronts or automated procurement on one open-source headless ecommerce platform.<\/p>\n

\r\n See Enterprise Edition<\/a>\r\n <\/div>\r\n <\/div>\r\n
\r\n \"\"\r\n <\/div>\r\n <\/div>\r\n <\/section>\r\n\r\n\n\n\r\n
\r\n
\r\n\t\t\t
\r\n\t\t\t\t

What you get<\/p>\n

What you can build with a headless ecommerce platform<\/h2>\n

Storefronts, B2B portals, marketplaces, mobile apps, and multi-tenant platforms from one commerce backend<\/p>\n\t\t\t<\/div>\r\n \t\t\t

\r\n \t\t\t\t
\r\n\t\t\t\t\t
\r\n \"\"\r\n <\/div>\r\n\t\t\t\t\t

Any storefront<\/p>\r\n\t\t\t\t\t

Connect Next.js, React, Vue, or any frontend. The REST API handles cart, checkout, product discovery, and account management. OpenAPI 3.0 specs let mobile teams generate Swift or Kotlin clients in minutes.<\/p>\r\n\t\t\t\t<\/div>\r\n \t\t\t\t

\r\n\t\t\t\t\t
\r\n \"\"\r\n <\/div>\r\n\t\t\t\t\t

B2B and marketplace<\/p>\r\n\t\t\t\t\t

Wholesale portals with customer-specific pricing, buyer organizations, and approval workflows. Multi-vendor marketplaces with Stripe Connect payouts. All on the same platform.<\/p>\r\n\t\t\t\t<\/div>\r\n \t\t\t\t

\r\n\t\t\t\t\t
\r\n \"\"\r\n <\/div>\r\n\t\t\t\t\t

Open source, self-hosted<\/p>\r\n\t\t\t\t\t

BSD 3-Clause license. Deploy on any cloud or on-premises. Audit every line of code. Zero platform fees, zero vendor lock-in.<\/p>\r\n\t\t\t\t<\/div>\r\n \t\t\t<\/div>\r\n \t\t<\/div>\r\n <\/section>\r\n\r\n\n\n\r\n

\r\n
\r\n

Success stories<\/h2>\r\n\r\n
\r\n See all Stories<\/span><\/a>\r\n <\/div>\r\n
\r\n \r\n\r\n
\r\n
\r\n \r\n \"GoDaddy\r\n <\/a>\r\n\r\n <\/div>\r\n
\r\n
\r\n \r\n Composable <\/a>\r\n <\/div>\r\n

\r\n GoDaddy chose Spree for their multi-tenant Ecommerce solution for small businesses<\/a>\r\n <\/p>\r\n <\/div>\r\n<\/article>\r\n\r\n\r\n

\r\n
\r\n \r\n \"Greetabl.com\r\n <\/a>\r\n\r\n <\/div>\r\n
\r\n
\r\n \r\n DTC <\/a>\r\n <\/div>\r\n

\r\n Greetabl.com business streamlined by a custom Spree Commerce implementation & fulfillment integration<\/a>\r\n <\/p>\r\n <\/div>\r\n<\/article>\r\n\r\n\r\n

\r\n
\r\n \r\n \"video\r\n <\/a>\r\n\r\n <\/div>\r\n
\r\n
\r\n \r\n Composable <\/a>\r\n <\/div>\r\n

\r\n A video livestream shopping mobile app with a headless marketplace Spree backend<\/a>\r\n <\/p>\r\n <\/div>\r\n<\/article>\r\n\r\n\r\n

\r\n
\r\n \r\n \"Spree\r\n <\/a>\r\n\r\n <\/div>\r\n
\r\n
\r\n \r\n Digital products <\/a>\r\n <\/div>\r\n

\r\n Spree powers a headless marketplace for digital downloads such as animation elements and GIFs<\/a>\r\n <\/p>\r\n <\/div>\r\n<\/article>\r\n <\/div>\r\n <\/div>\r\n <\/section>\r\n\r\n\n\n\r\n

\r\n
\r\n \n\n

Frequently Asked Questions<\/h2>\n\n\r\n <\/div>\r\n
\r\n
\r\n
\r\n \r\n What is a headless ecommerce platform?<\/span>\r\n \r\n \r\n \r\n \r\n <\/g>\r\n <\/svg>\r\n <\/summary>\r\n
\r\n

A headless ecommerce platform separates the backend (products, orders, payments) from the frontend (what customers see and interact with). The two communicate through APIs, so development teams can build any customer experience using their preferred framework without being locked into the platform’s built-in templates. This architecture gives complete control over performance, design, and multi-channel delivery.<\/p>\n <\/div>\r\n <\/details>\r\n<\/div>\r\n

\r\n
\r\n \r\n How does a headless ecommerce platform connect to a frontend?<\/span>\r\n \r\n \r\n \r\n \r\n <\/g>\r\n <\/svg>\r\n <\/summary>\r\n
\r\n

Through REST or GraphQL APIs. The frontend makes API calls to fetch product data, manage carts, and process checkout. Spree Commerce uses a REST API with OpenAPI 3.0 specs and a TypeScript SDK, so frontend teams get type safety and autocomplete in their IDE. Mobile teams can generate Swift or Kotlin clients directly from the OpenAPI spec without writing API integration code manually.<\/p>\n <\/div>\r\n <\/details>\r\n<\/div>\r\n

\r\n
\r\n \r\n What are the benefits of open source headless ecommerce?<\/span>\r\n \r\n \r\n \r\n \r\n <\/g>\r\n <\/svg>\r\n <\/summary>\r\n
\r\n

Open source headless ecommerce gives teams three things closed platforms lack: full code visibility for security audits, deployment flexibility across any cloud provider, and zero platform fees on revenue. Spree Commerce is free and open source, so teams inspect, modify, and deploy the commerce backend without licensing constraints or per-transaction costs that scale with growth.<\/p>\n <\/div>\r\n <\/details>\r\n<\/div>\r\n

\r\n
\r\n \r\n Which headless ecommerce platform works with Next.js?<\/span>\r\n \r\n \r\n \r\n \r\n <\/g>\r\n <\/svg>\r\n <\/summary>\r\n
\r\n

Several headless platforms offer Next.js integration, but most require teams to build the storefront from scratch. Spree Commerce ships a production-grade Next.js storefront starter built on Next.js 16, React 19, and TypeScript 5, with server-side rendering and a typed SDK. Teams fork the starter repo and start customizing immediately rather than wiring up API calls from a blank project.<\/p>\n <\/div>\r\n <\/details>\r\n<\/div>\r\n

\r\n
\r\n \r\n How does headless ecommerce handle payments without vendor lock-in?<\/span>\r\n \r\n \r\n \r\n \r\n <\/g>\r\n <\/svg>\r\n <\/summary>\r\n
\r\n

Payment provider lock-in happens when your checkout code is tightly coupled to a single PSP. A headless ecommerce platform with a provider-agnostic payment layer avoids this. Spree Commerce uses a Payment Sessions API where checkout code stays the same regardless of whether you process through Stripe, Adyen, or another provider. Swapping PSPs requires configuration changes, not a checkout rewrite.<\/p>\n <\/div>\r\n <\/details>\r\n<\/div>\r\n

\r\n
\r\n \r\n What is the difference between headless and traditional ecommerce?<\/span>\r\n \r\n \r\n \r\n \r\n <\/g>\r\n <\/svg>\r\n <\/summary>\r\n
\r\n

Traditional ecommerce platforms bundle the storefront with the backend: you customize within the platform’s theme system. Headless platforms expose commerce functionality through APIs and let you build the frontend independently. The tradeoff is development effort for design freedom. Headless fits teams that need custom storefronts, mobile apps, or multi-channel experiences beyond what a template system supports.<\/p>\n <\/div>\r\n <\/details>\r\n<\/div>\r\n

\r\n
\r\n \r\n Can a headless ecommerce platform support B2B and B2C?<\/span>\r\n \r\n \r\n \r\n \r\n <\/g>\r\n <\/svg>\r\n <\/summary>\r\n
\r\n

Yes. A headless backend manages the commerce logic (buyer organizations, approval workflows, price lists, customer segments) while separate frontends serve each audience. Spree Commerce runs B2B and B2C storefronts from a single instance, with buyer-specific pricing and gated catalogs on the B2B side and a consumer storefront on the B2C side, all powered by the same REST API.<\/p>\n <\/div>\r\n <\/details>\r\n<\/div>\r\n <\/div>\r\n <\/section>\r\n\r\n\r\n\r\n