Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.stella-commerce.com/llms.txt

Use this file to discover all available pages before exploring further.

Stella is a multi-tenant commerce backend you can build any storefront on top of. Every API surface is shared across three caller types — your own storefront, your logged-in customers, and AI agents acting on their behalf — so you build the buying flow once and the agentic flow comes along for free.

​
What ships today

Storefront API

Catalog, cart, checkout, search, discounts. Public per-merchant endpoints under /api/storefront/*.

Customer Account API

Register, log in, manage addresses and order history. Per-customer cust_… tokens.

Stella-hosted Checkout

Stripe-powered checkout SPA. Per-merchant theme. Stella stays in PCI scope so merchants don’t have to.

Agent Capability Tokens

OAuth Device Authorization (RFC 8628) consent flow. Scoped, budget-capped, audit-logged. The differentiator.

​
Three-tier token model

The thing Shopify doesn’t have: every merchant gets agent traffic for free because /api/agent/* is just a different token type on the same backend. 
MERCHANT          →  Storefront Access Token (stk_…)
                     header: X-Stella-Token

CUSTOMER (login)  →  Customer Access Token (cust_…)
                     header: Authorization: Bearer cust_…

CUSTOMER delegates →  Agent Capability Token (agt_…)
TO AGENT             header: Authorization: Bearer agt_…
                     scoped, budget-capped, audit-logged
See the authentication overview for the full model.

​
Get started

5-minute quickstart

Mint a token, list products, create a cart, redirect to checkout.

API reference

Full surface: 130+ endpoints across Storefront, Customer, Agent, and Dashboard APIs.