CEMAC POS developer API
A versioned REST API (/api/v1), token-authenticated (Sanctum), multi-tenant. Build your integrations: products, customers, sales, loyalty, reports and offline sync.
Authentication
POST /api/v1/auth/login returns a Bearer token.
Resources
Products, categories, customers, sales — full CRUD.
Sync
Pull/push endpoints for offline clients.
Quick start
# 1. Get a token curl -X POST https://cemacpos.com/api/v1/auth/login \ -H "Content-Type: application/json" \ -d '{"email":"owner@cemacpos.cm","password":"password"}' # 2. List products curl https://cemacpos.com/api/v1/products \ -H "Authorization: Bearer <TOKEN>" # 3. Record a sale curl -X POST https://cemacpos.com/api/v1/sales \ -H "Authorization: Bearer <TOKEN>" \ -H "Content-Type: application/json" \ -d '{"items":[{"product_id":"<ID>","quantity":2}], "payments":[{"method":"mtn_momo","amount_xaf":7000}]}'
Main endpoints
| Method | Path | Description |
|---|---|---|
| POST | /api/v1/auth/register | Create a shop (trial) |
| POST | /api/v1/auth/login | Get a token |
| GET | /api/v1/products | List / search products |
| GET | /api/v1/customers | List customers & loyalty |
| POST | /api/v1/sales | Record a sale |
| GET | /api/v1/sales/{id}/receipt | ESC/POS receipt (58/80mm) |
| GET | /api/v1/reports/z | Daily Z report |
| GET | /api/v1/sync/pull | Fetch offline deltas |
| POST | /api/v1/sync/push | Send offline changes |
Full interactive reference: /api-docs. Every request is multi-tenant: a token only sees its own shop's data.