Help

Errors

Error body, error codes and what to do about each.

JSON

{ "error": { "code": "INVALID_AMOUNTS", "message": "itemsSubtotal must be 2700", "path": "amounts.itemsSubtotal",
             "requestId": "6b1f…" } }

path is present for field errors, in dot notation with array indexes as numbers (items.0.unitPrice).
details is present for some errors.
Quote requestId when you contact support. If you send an x-request-id header, we use yours.

HTTP	`code`	Meaning	What to do
400	`MALFORMED_REQUEST`	The body is not valid JSON.	Fix the request.
401	`UNAUTHORIZED`	Key missing, wrong, expired or revoked.	Check the key; ask the restaurant for a new one.
403	`CONNECTION_REVOKED`	The restaurant deleted the connection.	Stop sending.
404	`ORDER_NOT_FOUND`	Unknown order, or another connection's.	–
409	`STORE_OFFLINE`	The restaurant is not taking orders through this connection.	Send again once it is `online`.
409	`WEBHOOK_NOT_CONFIGURED`	No webhook URL is set.	`PUT /webhook` first.
409	`ORDER_CONFLICT`	The `externalId` exists with a different payload.	Use a new `externalId`.
409	`INVALID_TRANSITION`	Cancel of a completed or rejected order; courier update for an order the restaurant delivers.	–
409	`REQUEST_IN_PROGRESS`	The same order is still being received, or secret rotations collide.	Retry after `Retry-After`.
422	`INVALID_FIELD`	Schema violation (see `path`), invalid webhook URL, invalid payment combination.	Fix the request.
422	`INVALID_AMOUNTS`	Sums or `amountPaid` do not add up.	Fix the sums.
422	`CURRENCY_MISMATCH`	Not the restaurant's currency.	Use the menu file's `currency`.
429	`RATE_LIMITED`	Too many requests.	Retry after `Retry-After`.
500	`INTERNAL_ERROR`	Our failure.	Retry with the same body.
503	`SERVICE_UNAVAILABLE`	A service we depend on is not reachable.	Retry later.