Intro

ZephyrCart is a headless commerce platform: storefronts call our HTTP API, we own carts, checkouts, orders, customers, and the tax + payment plumbing behind them. We deliberately ship no embeddable admin UI: the expectation is that you build your own.

What this documentation covers

  • The HTTP API at https://api.zephyrcart.io/v1
  • Webhook events and signature verification
  • Official SDKs (TypeScript, Python, Go, Ruby) and the language-agnostic OpenAPI spec
  • Reference architectures for the three deployment shapes we actively support

What it does not cover

  • The marketing site at zephyrcart.io (out of scope; talk to the growth team)
  • The legacy v0 API — scheduled for end of life 2026-12-31, migration guide forthcoming
  • Internal runbooks (those live on the intranet, authenticated)

A note on conventions

Every endpoint in this documentation is shown with curl because every visitor can read it. Language-specific snippets follow in the SDK section. When an example uses a placeholder we wrap it in angle brackets, e.g. <api-key> — never copy it verbatim.