Versioning & Conventions

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

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 and Customers

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…

Catalog

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…

Shops

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…

Authentication

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

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…

Store API Reference

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…

Security Practices

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…

Troubleshooting

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…