Versioning & Conventions - Paths use integer ids where shown as {id}, {pid}, {vid}, {cid}, {aid}, {oid}, {rid}. - Money fields in product/order payloads are typically integer cents (same as…
Content, Discounts & Settings Requires shop Bearer unless noted. Discounts Coupon list uses POST /discounts/coupons-list (admin convention). CRUD on / discounts/coupons/{id}; thresholds and settings via GET/PUT. Pages & menus -…
Orders Requires shop Bearer. Mirrors admin order actions (fulfillment, tracking, Shiprocket, mark-as-). curl -sS "$API_BASE/v1/account/api/orders" \ -H "Authorization: Bearer $SHOP_TOKEN" curl -sS "$API_BASE/v1/account/api/orders/5001" \ -H "Authorization: Bearer $SHOP_TOKEN" curl -sS…
All endpoints require shop Bearer. Products Typical create/update payloads match the admin product form (title, handle, description HTML, options/variants, prices in integer cents, status, SEO fields, etc.). Variable products: each…
4.1 List shops — GET /v1/account/api/shops Requires account Bearer. curl -sS "$API_BASE/v1/account/api/shops" \ -H "Authorization: Bearer $ACCOUNT_TOKEN" Each item includes id, handle, host, name, site_language, timezone, currency, timestamps. 4.2 Check…
3.1 Login — POST /v1/account/api/auth/login No captcha. No Bearer header. Body { "email": "you@example.com", "password": "YOUR_PASSWORD" } Success (200) { "access_token": "", "refresh_token": "", "expires_in": 21600, "token_type": "bearer", "sms_verified": true,…
Endpoint directory All paths are relative to /v1/account/api. 2.1 Auth & shops (account token unless noted) Method Path Auth Notes POST /auth/login — Email + password → account tokens POST…
HTTP API for merchants and integration partners to manage a Zencommerce store the same way as the accounts and admin web apps: sign in → select a store → run…
List of security practices for usage of webhooks Serve your webhook URL over HTTPS only (enforced on create and update). Verify X-Webhook-Signature on every request before trusting the body. Store…
Tabulated below are list of Symptoms and their respective Solutions Symptom What to check Subscription create returns 403 Merchant has enabled webhooks for that store handle No event arrives Merchant…