OverviewIntroduction

Introduction

Storentia is a multi-tenant storefront platform. Each merchant runs one or more stores — products, variants, collections, carts, orders, pages, and blog posts all live under a store. The platform is split into a few purpose-built services rather than one monolith, and the docs below follow that split.

Start here

You need a Storentia account and at least one store.

  1. Sign in with email OTP — no separate signup step, the account is created on first login.
  2. Create a store via the onboarding API or the dashboard.
  3. Register an OAuth app for that store to get SDK/API credentials — see OAuth apps & public tokens.
  4. Open the Quick Start to create a store and register an app end to end.

The three surfaces

  • REST account & store API (apis.storentia.com/v1) — login, sessions, store onboarding, OAuth app management, public tokens, subscriptions, payments, and admin analytics. Authenticated with a personal JWT access token.
  • Storefront GraphQL API — products, variants, collections, cart, orders, pages, and blog content for a single store. Authenticated with either a store-scoped public token or an OAuth app access token.
  • App Registry — the marketplace backend: publish apps, browse categories, and manage per-store app installations with encrypted credentials.

Who uses what

If you are building on top of a store — a custom frontend, a headless storefront, an integration app — you will spend almost all of your time in the storefront GraphQL API, reached through the Node.js or Python SDK. The REST API is what the Storentia dashboard itself calls to manage accounts, stores, and billing.