AyolShop — COD commerce, from API to storefront.
AyolShop is the platform behind cash-on-delivery storefronts across Algeria — orders, carriers, catalogs, reviews and themes, with typed SDKs and an OAuth-secured MCP server.
{
"name": "Dar Zina",
"lang": "ar",
"locale": "ar",
"currency": "DZD",
"currencySymbol": "دج",
"cartEnabled": false,
"reviewsEnabled": true,
"locales": [
{ "code": "ar", "direction": "rtl" },
{ "code": "fr", "direction": "ltr" }
]
}npm i @wocart/storefront @wocart/themeOpenAPI 3.1
Generated, typed reference
58
Wilayas covered
4
Carrier adapters
OAuth
MCP authentication
Choose your entry point
Four ways into AyolShop.
AyolShop opens four doors: integrate the REST API, build a storefront, ship a theme merchants can edit, or let an AI client work through MCP. Each path has its own guide and its own reference.
Platform API
Orders, shipments, catalogs, customers and store settings behind one typed REST API.
GET /api/ordersExplore the APIStorefront SDK
The commerce engine: store config, catalog, basket, checkout, reviews and delivery.
npm i @wocart/storefrontRead the guideTheme SDK
Themes merchants edit in AyolShop Studio: component definitions, page documents, style and preview, with a starter that creates a complete theme.
npm i @wocart/themeBuild a themeMCP server
Let AI clients read and act on a store through an OAuth-secured Model Context Protocol endpoint.
OAuth · MCPConnect a clientQuickstart
From zero to your first order.
Create a merchant key, send one request, then explore every endpoint in the interactive playground. Two keys exist, and they never mix: a merchant key acts on your store, a store key only reads what a storefront renders.
- 1Create a merchant API key in the dashboard.
- 2Send your first request with the X-API-Key header.
- 3Explore every endpoint in the interactive playground.
- 1
Merchant API
Orders, shipments, catalog
X-API-Key: $COD_API_KEY - 2
Store API
What a storefront reads
X-Store-API-Key: $STORE_API_KEY - 3
Typed client
Server-side, one per request
npm i @wocart/storefront
The merchant key is scoped to your store. The store key never leaves the server.
Ship the storefront you want.
Build it with AyolShop's two SDKs: the storefront SDK for the engine and the theme SDK for the layer merchants edit. The theme starter gives you a complete theme to start from.