The Vantage View | Salesforce

Salesforce Headless Commerce: SCAPI, PWA Kit, Composable Storefronts

Written by David Cockrum | Sep 7, 2026, 12:00:01 PM

This is Part 5 of Vantage Point's Headless 360 series. Part 1 maps the platform-wide architecture, availability, and governance model; earlier parts cover the developer and admin perspectives and the HXL/Mosaic experience layer; the final part covers headless identity. This post goes deep on commerce: SCAPI, PWA Kit, Managed Runtime, and composable storefronts.

With Dreamforce weeks away, headless commerce deserves a spot on your prep list. It is the most mature headless surface Salesforce ships — years in production, a clear migration path, and a developer experience that keeps improving. This guide covers the pieces, who they fit, and how commerce connects to the broader Headless 360 vision.

Quick Answer

 

Headless commerce on Salesforce means running your storefront's front end completely separately from the Salesforce B2C Commerce engine, with every shopper interaction — browsing, search, cart, checkout, account — flowing through the Salesforce Commerce API (SCAPI). Salesforce's opinionated path is the Composable Storefront: a React front end built with PWA Kit, deployed and hosted on Managed Runtime. Start with the Composable Storefront overview and the Trailhead Headless Commerce Basics module.

TL;DR

  • What it is: A decoupled storefront architecture where a custom front end talks to Salesforce B2C Commerce through SCAPI — no server-rendered templates required.
  • Why it matters now: OCAPI, the legacy API layer, was marked deprecated in April 2026. SCAPI is the modern standard, and all new implementations are expected to use it.
  • The opinionated path: PWA Kit (React framework) plus Managed Runtime (hosting and operations) equals Salesforce's Composable Storefront.
  • Best for: B2C commerce teams that need front-end agility, performance control, or experiences beyond a traditional web storefront.
  • How Vantage Point helps: Senior consultants help you choose the right storefront architecture and plan a phased migration through our Salesforce implementation and advisory practice.

What Is Headless Commerce on Salesforce?

Headless commerce is an architecture where products, prices, content, and cart logic live in the commerce platform and are delivered through APIs, while the front-end experience is built and deployed separately. As Salesforce's Headless Commerce Basics module puts it: content is stored and delivered without a front-end layer attached.

On Salesforce, the "body" is B2C Commerce — the engine that manages catalogs, pricing, promotions, inventory, baskets, and orders. The "head" is whatever experience you build: a React web storefront, a mobile app, an in-store kiosk, or all of them at once against the same backend. Because the front end is decoupled, your team ships experience changes on its own release cadence, and one commerce engine serves every surface consistently — the same idea behind Headless 360, applied where Salesforce has the longest headless track record.

Why Does Headless Commerce Matter in 2026?

Three reasons make this a 2026 conversation rather than a someday one:

  • The legacy path has a date on it. OCAPI, the Open Commerce API behind earlier headless builds, was marked deprecated as of April 2026. Per Salesforce's Why Use SCAPI guidance, OCAPI gets security updates for a limited window, but no new features — and all new implementations are directed to SCAPI.
  • Innovation is concentrated in SCAPI. Native personalization through the Shopper Context API, load shedding and rate limiting for traffic resilience, and hybrid authentication that bridges legacy and modern storefronts all live on the SCAPI side.
  • Dreamforce will push the platform-wide story. Commerce teams who already understand SCAPI and composable storefronts will recognize the Headless 360 pattern immediately — and evaluate announcements faster.

What Is SCAPI, and How Is It Organized?

SCAPI — the Salesforce Commerce API, formally the B2C Commerce API — is a set of RESTful APIs for building storefronts, merchant tools, and integrations on B2C Commerce. Introduced in 2020 and built headless-first, it is stateless, designed for high-scale customer-facing traffic, and organized into two families:

  Shopper APIs Admin APIs
Purpose Customer-facing: browsing, search, cart, checkout Merchant-facing: product, order, inventory management
Authentication SLAS (OAuth 2.1) Account Manager
Scale High-scale, supports anonymous guest shoppers Moderate usage
Access Mostly read-only (exceptions: Baskets, Orders) Read and write
Naming API names start with "Shopper" No naming convention
  • SLAS is the front door. The Shopper Login and API Access Service issues shopper tokens, and its hybrid auth lets one session span legacy SFRA pages and a modern PWA storefront — the key to a phased migration without lost baskets.
  • The SDKs are mature. Salesforce maintains commerce-sdk for Node.js, commerce-sdk-isomorphic for server and browser, and @salesforce/commerce-sdk-react for React hooks, plus a Postman collection.
  • AI-assisted development is here too. A B2C DX MCP Server (developer preview) lets AI coding assistants explore SCAPI from your IDE — the same MCP pattern covered in Part 2 of this series, "Salesforce Headless 360 for Developers."
  • Operational guardrails exist. SCAPI requests are rate limited, Shopper APIs carry tight timeouts, and correlation IDs trace requests end to end.

What Are PWA Kit and Managed Runtime?

You can build a headless front end on SCAPI with any framework. Salesforce's opinionated, supported path is the Composable Storefront, and it has two halves:

PWA Kit is the front-end framework — an open-source, React-based toolkit for building progressive web app storefronts on SCAPI, with scaffolding, server-side rendering, and commerce-sdk-react hooks. The PWA Kit overview walks the architecture; the codebase lives on GitHub.

Managed Runtime (MRT) is the operations half — Salesforce-managed cloud infrastructure to deploy, host, and monitor your storefront, with dev, staging, and production environments; a Runtime Admin UI; and observability tooling like Log Center. See the Managed Runtime overview.

Together — PWA Kit for the front end, Managed Runtime for hosting, SCAPI for data and transactions — you get the Composable Storefront: a complete, supported headless stack with clear ownership boundaries.

How Does the Composable Storefront Developer Workflow Work?

The day-to-day workflow, outlined in the Composable Storefront overview, looks like this:

  1. Set up API access. Register a SLAS client, define scopes, and configure your B2C Commerce instance connection.
  2. Generate a project. Scaffold a storefront from a PWA Kit template with your sandbox configuration.
  3. Develop locally. Build pages and components in React, pulling live catalog, search, basket, and checkout data through commerce-sdk-react hooks.
  4. Push and deploy. Bundle and deploy to a Managed Runtime environment; promote as it matures.
  5. Monitor and iterate. Use Log Center, server-timing metrics, and storefront preview to tune performance and merchandising.

Which Storefront Approach Fits Your Team?

Salesforce publishes a storefront type comparison to help teams choose. The practical decision:

Approach Front end Hosting Best for
SFRA (Storefront Reference Architecture) Server-rendered templates on the platform B2C Commerce platform Teams maintaining an existing site; no near-term headless need
Composable Storefront (PWA Kit + MRT) React PWA you own Managed Runtime B2C teams wanting front-end agility with a supported, opinionated stack
Custom headless on SCAPI Any framework, mobile app, kiosk, or channel Your infrastructure Teams with existing front-end platforms or non-web surfaces

The decision rules of thumb: new B2C storefronts should start with the Composable Storefront, where Salesforce's investment and documentation are concentrated. Teams on SFRA with OCAPI integrations should plan a phased migration using SLAS hybrid auth, not a big-bang rebuild. And if your roadmap includes mobile or in-store experiences, headless stops being optional — one SCAPI backend can serve them all.

How Does Headless Commerce Connect to Headless 360?

Headless 360, mapped in Part 1 of this series, is the platform-wide commitment to making every Salesforce capability available through APIs, MCP tools, and CLI commands. Commerce is where that pattern is most proven, and the connections keep tightening:

  • MCP comes to storefront development. The PWA Kit MCP Server (developer preview) lets AI coding assistants accelerate PWA Kit development, and the B2C DX MCP Server does the same for SCAPI exploration — the build-time agent pattern from Part 2, applied to commerce.
  • Data 360 closes the loop. PWA Kit storefronts can send engagement events to Data Cloud, so shopper behavior joins the unified customer profile behind personalization and agents.
  • The governance model carries over. Identity, least-privilege scopes, and environment discipline matter as much here as anywhere in Headless 360 — Part 1's readiness checklist applies directly.

The series' customer proof points reinforce the pattern: Salesforce's own IT team runs employee-facing operations headlessly inside Slack (Salesforce on Salesforce), and Indeed's engineering team deploys production agents without opening a browser. Different surfaces, same principle — pick a bounded workflow, expose it through governed interfaces, expand from there.

What Should Commerce Teams Do Before Dreamforce?

  1. Take the Trailhead module. Headless Commerce Basics gives your team shared vocabulary in about an hour.
  2. Read the two SCAPI guides. Get Started with SCAPI for the API surface, and Why Use SCAPI for the deprecation and migration picture.
  3. Audit your current state. If you run SFRA or OCAPI integrations, inventory the endpoints you depend on — that list drives migration scope.
  4. Spin up a PWA Kit sandbox project. Generate a storefront from the template and walk the developer workflow end to end.
  5. Review the storefront-type guide. Salesforce's comparison of B2C storefront options will sharpen the questions you bring to Dreamforce.
  6. Connect it to your Headless 360 plan. Commerce decisions now shape your data, identity, and agent surfaces later — read them alongside Part 1.

How Vantage Point Helps

Vantage Point helps commerce and digital teams make the headless decision with clear eyes: choosing between SFRA, Composable Storefront, and custom headless; scoping a phased OCAPI-to-SCAPI migration; and connecting storefront architecture to your broader Salesforce roadmap. Through our Salesforce implementation and advisory and system integration and data migration services, senior consultants design the architecture, identity model, and pilot plan so you build on solid ground. Senior consultants only — no junior handoffs; the experts you meet are the experts who deliver.

Ready to Plan Your Headless Commerce Move?

 

Whether you are evaluating a composable storefront, planning an OCAPI migration, or mapping commerce into your Headless 360 strategy ahead of Dreamforce, Vantage Point's senior consultants can help you move from evaluation to a concrete plan. Contact Vantage Point to schedule a headless commerce readiness session, or explore our Salesforce services to see how we support commerce teams end to end.

Frequently Asked Questions

What is SCAPI in Salesforce?

SCAPI — the Salesforce Commerce API, formally the B2C Commerce API — is a set of RESTful APIs for building storefronts, merchant tools, and integrations on Salesforce B2C Commerce. It is headless-first and stateless, split into high-scale Shopper APIs for customer-facing traffic and Admin APIs for merchant operations.

Is Salesforce OCAPI deprecated?

Yes. OCAPI was marked deprecated as of April 2026. It gets security updates for a limited window, but no new features, and Salesforce directs all new implementations to SCAPI. Existing OCAPI users should audit their usage and plan a phased migration, using SLAS hybrid authentication to bridge both API sets during the transition.

What is the difference between PWA Kit and Managed Runtime?

PWA Kit is the front-end framework — an open-source, React-based toolkit for building progressive web app storefronts on SCAPI. Managed Runtime is the hosting and operations layer — Salesforce-managed infrastructure for deploying, hosting, and monitoring those storefronts. Together they form Salesforce's Composable Storefront.

Do I need React developers to build a composable storefront?

For the Composable Storefront path, yes — PWA Kit is React-based. The upside: React skills are widely available, so you are not hiring for a proprietary templating language. A fully custom headless build on SCAPI can use any framework your team already knows.

Can we migrate from SFRA to a composable storefront gradually?

Yes, and that is the recommended pattern. SLAS hybrid authentication lets a single shopper session span legacy SFRA pages and modern PWA storefront pages, so you can move high-value routes incrementally without losing baskets or forcing a big-bang cutover.

Is headless commerce only for large enterprises?

No. It fits any B2C team that needs front-end agility, performance control, or experiences beyond a single web storefront. The real threshold is organizational: front-end development capacity plus a reason to move faster than a template-based storefront allows.

How does headless commerce relate to Salesforce Headless 360?

Headless 360 is Salesforce's platform-wide commitment to exposing every capability through APIs, MCP tools, and CLI commands. Headless commerce is its most mature expression, and it now connects back through MCP servers for AI-assisted development and Data Cloud engagement events for unified customer data.

Vantage Point is a boutique CRM consulting firm helping businesses transform with Salesforce, HubSpot, and AI — 150+ clients, 400+ engagements, and a 4.71/5 average engagement rating. Learn more at vantagepoint.io.