Error response format
code field is present for structured errors but may be omitted for simple validation failures.
Common HTTP status codes
| 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 |
Error codes
| 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 |