docs
Open dashboard

Changelog

Commerce API changelog

2026-01 (current)

The first published version of /admin/2026-01/ and /storefront/2026-01/ surfaces.

Phase 1 transactional core

  • Catalog (products, variants, pricing, collections, media)
  • Customers + addresses + segments + GDPR redaction
  • Orders + payments + fulfillments + returns
  • Inventory + locations + reservations + immutable ledger
  • Discounts + vouchers (gift cards)
  • Shipping zones + methods + rates + quote engine
  • Tax categories + rates + VIES validation cache

Layer 5 customizability

  • Settings registry (typed, hierarchical, 26 built-in keys)
  • Themes (storefront design tokens, drafts via parent_theme_id)
  • Email templates (MJML / HTML / plain, locale fallback)
  • Notification preferences (per customer × event × channel, wildcards)

Email loop

  • email-renderer Node service (MJML + Handlebars)
  • outbox-dispatcher Python worker (LISTEN/NOTIFY + poll)
  • Resend webhook ingest with HMAC verification
  • email_deliveries audit log + status updates from provider events

Checkout (Layer 4.6)

  • Cart + checkout two-table model (Q1=B)
  • Headless storefront API (Q2 — hosted UI deferred)
  • Storefront API keys with origin allowlist (Q3=C)
  • Inventory reservation timing config (Q4 — commerce.checkout.reserve_at)
  • Eager pricing recompute (Q5)
  • Payment connector framework + COD + bank_transfer (Q6 — gateways reserved)
  • VIES fail-open with cache (Q7)
  • Multi-currency cart reject (Q8)
  • Idempotency-Key required on complete (Q9)
  • Customer row created on complete only (Q10)

Conventions

URLs in /admin/2026-01/ and /storefront/2026-01/ are stable. Additive changes (new fields, new endpoints, new optional query params) can land any time — your code should ignore unrecognised fields.

Breaking changes go under a new version segment (2027-01).

What's not yet shipped

  • Real payment gateways: Stripe, Comgate, GoPay (framework reserved)
  • Hosted checkout UI app (apps/checkout/)
  • Webhook delivery framework (commerce-api as outbound webhook sender)
  • Connector framework (Shopify import, AbraGen export)
  • MCP commerce tools (per-feature surfaces for AI agents)
  • Storefront search (Meilisearch / Typesense integration)
  • Subscriptions / recurring billing
  • Real-time inventory sync (carrier API rates, supplier feeds)
  • POS terminal flow

These are tracked in services/commerce-api/PROGRESS.md. Roadmap is published in priority order in the dashboard.