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." }
  }
}
HTTPcodeMeaning
400invalid_jsonThe body is not valid JSON.
401unauthenticated / invalid_api_keyMissing or wrong secret key.
403ip_not_allowed, merchant_suspended, store_inactiveThe key may not be used.
404not_foundResource does not exist.
409idempotency_conflict, invalid_stateConflicting request.
422validation_failed, network_unavailable, limit_reachedInvalid input or business rule.
429rate_limitedToo many requests.
5xxserver_errorSomething went wrong on our side. Retry with the same Idempotency-Key.
Need help? Contact us Last updated: Nov 17, 2026