ecomone Docs
Ecomone for developers
Ecomone is a commerce platform for shops in Switzerland and the DACH region. Merchants run their storefront, direct-sale checkout, e-mail marketing and ads tracking in one place. As a developer you can connect to all of it.
What is Ecomone?#
Each merchant owns one or more shops. A shop has products, orders, customers, collections, discount codes, reviews, markets and a storefront theme. The API always works on exactly one shop per request, with the permissions (scopes) the merchant granted you.
Choose your integration#
| You want to… | Use | Auth |
|---|---|---|
| Connect your own shop to an ERP, warehouse or BI tool | REST API | API key created by the shop owner |
| Offer an app or service to many merchants | OAuth app + REST API | OAuth 2.1 access token |
| React instantly to new paid orders or refunds | Webhooks | HMAC signature |
| Let an AI agent build or manage a shop | MCP server | OAuth or API key |
| Sell from your own landing page through the Ecomone checkout | Landing page script | None (public, shop slug) |
Hosts#
| Host | Used for |
|---|---|
https://api.ecomone.shop | REST API (/api/public/v1/…) and MCP (/api/mcp) |
https://app.ecomone.shop | OAuth authorization server (consent screen, tokens) and the merchant backend |
Conventions#
- All requests use HTTPS. Request and response bodies are JSON (
Content-Type: application/json). - Money is always an integer in the smallest currency unit (
…_cents), together with an ISO currency code such asCHForEUR. - Timestamps are ISO 8601 in UTC, for example
2026-11-13T09:14:25.000Z. - IDs are UUIDs. Some detail endpoints also accept a handle, code or order number (noted per endpoint).
- Human-readable error messages are currently returned in German; rely on the stable
errorcode, not on the text.