AyolShop
AyolShop developer platform

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.

https://api.yourstore.com/store/config
GET/store/config200 OK
{
  "name": "Dar Zina",
  "lang": "ar",
  "locale": "ar",
  "currency": "DZD",
  "currencySymbol": "دج",
  "cartEnabled": false,
  "reviewsEnabled": true,
  "locales": [
    { "code": "ar", "direction": "rtl" },
    { "code": "fr", "direction": "ltr" }
  ]
}
Storefront config
Install the SDKsnpm i @wocart/storefront @wocart/theme

OpenAPI 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.

Quickstart

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.

  1. 1Create a merchant API key in the dashboard.
  2. 2Send your first request with the X-API-Key header.
  3. 3Explore every endpoint in the interactive playground.
Two keys, one rule
  1. 1

    Merchant API

    Orders, shipments, catalog

    X-API-Key: $COD_API_KEY
  2. 2

    Store API

    What a storefront reads

    X-Store-API-Key: $STORE_API_KEY
  3. 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.