Errors
Error format and codes.
Errors use conventional HTTP status codes and a consistent JSON body:
HTTP/1.1 422 Unprocessable Entity
{
"error": {
"code": "validation_failed",
"message": "The amount must be at least 1.",
"fields": { "amount": "The amount must be at least 1." }
}
}| HTTP | code | Meaning |
|---|---|---|
| 400 | invalid_json | The body is not valid JSON. |
| 401 | unauthenticated / invalid_api_key | Missing or wrong secret key. |
| 403 | ip_not_allowed, merchant_suspended, store_inactive | The key may not be used. |
| 404 | not_found | Resource does not exist. |
| 409 | idempotency_conflict, invalid_state | Conflicting request. |
| 422 | validation_failed, network_unavailable, limit_reached | Invalid input or business rule. |
| 429 | rate_limited | Too many requests. |
| 5xx | server_error | Something went wrong on our side. Retry with the same Idempotency-Key. |
Need help? Contact us
Last updated: Nov 17, 2026