Payment Gateway Sign in

Error reference

Every error response has the same shape. error is a string and stays a string for all of /v1. New code should read error_detail.

{
  "error": "amount must be positive",
  "error_detail": {"code": "invalid_request", "message": "amount must be positive", "field": "amount"}
}
StatusCodeMeaning
400invalid_requestThe body or a parameter is invalid. field names it when known.
401unauthorizedMissing, unknown, revoked or expired API key.
403forbiddenThe action is not allowed for this project.
403insufficient_scopeThe key lacks the scope. The body carries scope.
403limit_exceededA usage limit was hit. The body carries limit, current and max.
404not_foundNo such object, or it belongs to another project.
409conflictThe object is in the wrong state, or an idempotency key was reused with different parameters.
413payload_too_largeThe body is over 1 MiB.
429rate_limitedToo many requests. Wait for the Retry-After header.
502upstream_errorA provider failed. Retry later.
500internal_errorUnexpected failure. Retry with the same idempotency key.

Retry 429, 502 and 5xx with backoff. Do not retry other 4xx without changing the request.