Developer Docs · Adyvance Developers

REST API 16 endpoints for orders, products, customers, stock and webhooks, with an OpenAPI 3.1 file.Webhooks Signed events when an order is placed, paid, shipped or changed, retried until your server says yes.AI apps (MCP) Connect Claude, ChatGPT, Cursor or VS Code to a shop. Changes run only after a person says yes.

Quick start

Three steps from nothing to your first answer from the API.

Make an API key
In the Adyvance admin, open Apps → Developer → API keys and choose New key. Pick what the key may do (for example Read only), and copy the secret. It is shown once.
Copy your shop's address
The Quick start box on the same page shows the base address and your store's path, /orgs/org_…/stores/str_…, with your own IDs filled in.

Send a request

Put the key in the Authorization header. This lists your two newest orders:

Request

curl "https://app.adyvance.com/_public/v1/orgs/org_…/stores/str_…/orders?limit=2" \
  -H "Authorization: Bearer $ADYVANCE_API_KEY"

Response (shortened)

{
  "data": [
    {
      "id": "ord_…",
      "number": "1048",
      "channel": "web",
      "status": "confirmed",
      "payment_status": "paid",
      "fulfilment_status": "unfulfilled",
      "payment_method": "esewa",
      "customer_id": "cus_…",
      "contact": { "name": "Sita Sharma", "phone": "98XXXXXXXX", "email": null },
      "total_paisa": 420000,
      "due_paisa": 0,
      "is_test": false,
      "placed_at": "2026-11-05T09:12:44.000Z",
      "updated_at": "2026-11-05T09:20:03.000Z",
      "version": 3
    }
  ],
  "next_cursor": "…"
}

Money is in paisa

Every amount is a whole number of paisa: 420000 is Rs 4,200. Fields that hold money end in _paisa.

Addresses

What	Address
REST API	`https://app.adyvance.com/_public/v1`
MCP server	`https://mcp.adyvance.com/mcp`
OpenAPI file	/developers/openapi.json (version 2026-10-01)

Which plans include it

Feature	Free	Startup	Business
API keys and the REST API	No	Yes	Yes
AI apps (MCP)	No	Yes	Yes
Webhooks	No	No	Yes

The plan also sets how many requests a shop may make a minute. See Pricing and rate limits.

Coming later

A read-only headless storefront API (products, collections and price quotes with a browser-safe key) is built on the server, but shops cannot make its keys in the admin yet. It will be documented here when they can.

Need help?

Write to adyvanceofficial@gmail.com with the request_id from the error you got, and we will look it up.