Welcome

Sellvik is a multi-tenant commerce platform for Bangladeshi merchants. The developer platform lets you build on top of it: custom storefronts, ERP integrations, fulfillment workflows, and analytics pipes.

What's here

• Quickstart — mint a key, fire your first request, list products from a real shop.
• Storefront API — browser-safe catalog, cart, checkout, and customer auth. Use a publishable key.
• Admin API — server-to-server CRUD with scoped keys.
• Webhooks — subscribe to events, verify signatures, handle retries.
• Concepts — auth, tenancy, errors, pagination, rate limits — the rules that apply everywhere.

Design rules

We make a small number of opinions explicit so the rest of the API stays predictable:

1. REST + JSON, OpenAPI 3.1. Generate clients with openapi-typescript or anything else that eats OpenAPI.
2. Two key classes, no more. sk_live_… for servers, pk_live_… for browsers. Customer-bound endpoints additionally accept a JWT.
3. One canonical host. https://api.sellvik.app. Every v1 path also resolves from your tenant subdomain and from the apex domain — they're identical responses; routing is for convenience.
4. Errors are structured. Always { "error": { "code": "...", ... } }. Codes are stable across versions. See Errors.
5. No GraphQL. No batching DSL. If you need three resources, make three requests. They're cheap.
6. No silent breaking changes. v1 paths and response shapes are frozen. Additive changes (new fields, new endpoints) ship without notice. Breaking changes ship under v2.

Get help

• Email developers@sellvik.com — read by an engineer, replied to within a working day.
• File issues at github.com/sellvik/sellvik/issues with the label api.
• Bangladeshi merchants on Phase 0 plans: support is in English and Bangla; use whichever is easier.