Эта страница доступна только на английском. Код, поля API и идентификаторы не переводятся.

Errors

Every error has the same shape and a request ID for support.

json

{
  "error": {
    "type": "validation_error",
    "code": "invalid_amount",
    "message": "Amount must be a positive integer in the currency's minor unit.",
    "param": "amount",
    "request_id": "req_06GD..."
  }
}

Types

Type	HTTP	When
`authentication_error`	401	Missing, invalid or revoked API key
`authorization_error`	403	Key lacks a scope, or role lacks permission
`validation_error`	400	Invalid parameters
`not_found_error`	404	Object doesn't exist in your organization/environment
`conflict_error`	409	State conflict, e.g. an active payment already exists for the order
`idempotency_error`	409	Idempotency-Key reused with a different request
`payment_error`	402	The payment can't do this (not refundable, not open, …)
`provider_error`	502	The provider rejected or failed the request
`rate_limit_error`	429	Too many requests
`internal_error`	500	Something went wrong on OneGate's side — safe to retry with the same Idempotency-Key

Every response carries OneGate-Request-Id. Include it when contacting support.