Error Codes

All errors share one structure:

{
  "success": false,
  "error": { "code": "ERROR_CODE", "message": "Readable error message." }
}

code is stable and meant for your program; message is for humans and may change.

HTTP	code	Meaning	What to do
401	`INVALID_API_KEY`	Missing/unknown key	Check the `Authorization: Bearer` header
403	`API_KEY_DISABLED`	Key revoked or disabled	Use an active key / contact store owner
403	`STORE_DISABLED`	Store suspended	Contact Boostigo
403	`PLATFORM_NOT_ENABLED`	Likee not enabled for this key	Use a Likee key
403	`IP_NOT_ALLOWED`	Caller IP not in the key's whitelist	Update whitelist in the dashboard
422	`INVALID_LIKEE_ID`	Malformed Likee ID	Validate input
404	`USER_NOT_FOUND`	Likee account not found / deleted	Ask the customer to re-check the ID
422	`LIKEE_UID_MISMATCH`	`likee_uid` does not belong to `likee_id`	Re-run Identify, send the returned UID
422	`INVALID_DIAMOND_AMOUNT`	Diamond amount not in your price list	Use a configured amount
422	`AMOUNT_MISMATCH`	`amount` ≠ configured price	Update your price table
422	`INVALID_REQUEST_ID`	Missing/invalid `request_id`	1–100 chars, `A-Z a-z 0-9 _ . - :`
409	`DUPLICATE_REQUEST`	Reserved — replays return the existing order with `200` instead	—
402	`INSUFFICIENT_BALANCE`	Key balance < amount	Allocate funds to the key
404	`ORDER_NOT_FOUND`	Unknown order or not in your store	Check `order_id`
500	`RECHARGE_FAILED`	Recharge failed (inside a failed order's `error`)	Amount refunded; retry with a new `request_id`
429	`RATE_LIMIT_EXCEEDED`	Too many requests	Wait for `X-RateLimit-Reset`
400	`INVALID_JSON`	Body is not valid JSON	Send `Content-Type: application/json`
405	`METHOD_NOT_ALLOWED`	Wrong HTTP method	Use GET/POST as documented
404	`NOT_FOUND`	Unknown endpoint	Check the path
503	`SERVICE_UNAVAILABLE`	Likee upstream temporarily unavailable	Retry with backoff (same `request_id`)
500	`INTERNAL_ERROR`	Unexpected error on Boostigo's side	Retry later; contact support with the time & `request_id`

Boostigo never returns provider names, provider order ids, stack traces or database errors.