← Developer home

Doeh POS — Delivery API (1.0.0)

Download OpenAPI specification:

Public delivery API, served by the edge gateway. Authentication is a merchant bearer token; the shop/branch scope is derived from the token server-side (clients never send scope). Money is integer minor units. Error codes are a stable, append-only ABI — never renamed or reused.

Delivery

Create a delivery order

Idempotent when an Idempotency-Key is supplied (a retry returns the original order).

Authorizations:
MerchantAuth
header Parameters
Idempotency-Key
string <= 200 characters

Per-operation key. Strongly recommended on POST; enables safe retries (dedupe).

Trace-Id
string

Caller trace id, propagated and echoed on the response.

Request Body schema: application/json
required
currency
required
string (Currency)
Enum: "MMK" "THB" "USD" "CNY" "SGD" "INR"
amount_minor
required
integer >= 1

Amount in integer minor units (e.g. 1500 = 15.00). Never a decimal.

Responses

Request samples

Content type
application/json
{
  • "currency": "MMK",
  • "amount_minor": 1
}

Response samples

Content type
application/json
{
  • "ok": true,
  • "idempotent": true,
  • "order": {
    }
}

Read a delivery order

Authorizations:
MerchantAuth
path Parameters
id
required
string^[A-Za-z0-9_]+$
header Parameters
Trace-Id
string

Caller trace id, propagated and echoed on the response.

Responses

Response samples

Content type
application/json
{
  • "ok": true,
  • "idempotent": true,
  • "order": {
    }
}