Errors

Error response format

{
  "error": "Human-readable message",
  "code": "MACHINE_READABLE_CODE"
}

The code field is present for structured errors but may be omitted for simple validation failures.

Status	Meaning
400	Validation error, missing payout wallet, bad request body
401	Missing or invalid API key
403	Insufficient scope or store mismatch
404	Resource not found
409	External order ID conflict
429	Rate limit exceeded
500	Internal server error

Code	Description
`BOOTSTRAP_KEY_INVOICE_FORBIDDEN`	Connection key used for invoice creation
`EXTERNAL_ORDER_INTEGRATION_CONFLICT`	Order ID belongs to another integration
`INSUFFICIENT_SCOPE`	API key lacks required scope
`SITE_ALREADY_CONNECTED`	Woo site bound to another store
`INTEGRATION_NOT_FOUND`	Woo integration not found on disconnect
`CURRENCY_NOT_ALLOWED`	Invoice currency not in merchant allowlist