Commerce
Multi-tenant e-commerce backend — Shopify-style admin API + headless storefront API. Drives products, customers, orders, inventory, discounts, shipping, tax, payments, and a full transactional email loop (renderer + outbox dispatcher + Resend).
The Commerce API runs as a dedicated service (commerce-api,
port 8010) separate from the accounting monolith. One deploy can
host many e-shops; each shop is an account row with full RLS
isolation in Postgres.
Two HTTP surfaces
Admin API — https://api.nevios.io/admin/2026-01/{handle}/...
Auth: staff JWT or Personal Access Token. Used by the dashboard,
internal scripts, and AI agents. Mutates everything: products,
inventory, orders, settings, themes.
Storefront API — https://api.nevios.io/storefront/2026-01/...
Auth: per-account public X-Storefront-Key (pk_live_...) plus
opaque cart/checkout tokens in URLs. Used by browser/mobile
storefronts. Read-only for catalog, write for cart and checkout.
Where to start
| If you want to... | Read |
|---|---|
| See the whole flow in 5 minutes | Quickstart |
| Understand the architecture | Architecture |
| Authenticate your client | Authentication |
| Build a custom storefront | Carts → Checkouts |
| Manage products / inventory | Products → Inventory |
| Customize emails | Email templates → Email loop |
What ships today
Phase 1 transactional core complete. Latest test sweep: **349 Python
- 9 Node + 20 SQL invariants — all green** against live Supabase + Resend.
| Domain | Status | Endpoints |
|---|---|---|
| Catalog (products, variants, pricing, collections, media) | Live | 14 |
| Customers + addresses + segments | Live | 10 |
| Orders + payments + fulfillments + returns | Live | 38 |
| Inventory + locations + reservations | Live | 8 |
| Discounts + vouchers | Live | 14 |
| Shipping zones / methods / rates / quote | Live | 11 |
| Tax categories / rates / VIES | Live | 5 |
| Settings + themes + messaging | Live | 24 |
| Email send + deliveries + Resend webhook | Live | 5 |
| Carts + checkouts (storefront) | Live | 16 |
| Storefront API keys | Live | 3 |
| Total | ~129 endpoints |
Not yet shipped: real payment gateways (Stripe, Comgate, GoPay), hosted checkout UI app, MCP tools for commerce, Shopify import connector. The framework slots are reserved.