Errors

Error body:

{
  "error": "insufficient_balance",
  "message": "Недостаточно доступных средств",
  "request_id": "019d0120-7b59-7eab-b837-a7af38ea3db2"
}

Always log request_id when contacting support.

HTTP status

HTTP	Meaning
`200`	Success or idempotent replay
`202`	Accepted for async processing
`400`	Invalid parameters
`401`	Missing / invalid token
`403`	Missing scope or partner blocked
`404`	Object not found for this partner
`409`	`ext_id` conflict (different body)
`422`	Business rejection
`429`	Rate limit / cooldown / too many open docs
`500`	Internal error
`503`	Feature disabled

Code	Typical HTTP	Notes
`insufficient_balance`	422	No document created
`ext_id_conflict`	409	Same `ext_id`, different body
`product_unavailable`	422	Card product not allowed for tenant
`unknown_offer` / `offer_unavailable`	422	Bad / inactive offer
`invalid_address`	400 / 422	Withdraw address
`invalid_amount` / `invalid_value`	400 / 422	Amount rules
`missing_required_field`	400 / 422	Gift required fields
`catalog_stale`	422	Refresh gift catalog and retry
`kyc_rejected` / `invalid_customer_data`	422	Cardholder data
`card_not_active` / `card_already_frozen`	422	Card state
`not_found` / `card_not_found`	404	Resource missing for tenant
`unauthorized`	401	Token
`forbidden`	403	Scope / tenant state
`rate limit exceeded`	429	RPS window
`catalog cooldown`	429	Catalog min interval
`too many open documents`	429	Inflight create cap
`withdraw_limit_exceeded`	422	Daily withdraw cap
`catalog_disabled`	503	eSIM/gift catalog off
`gift_disabled`	503	Gift kill-switch
`withdrawals_disabled` / `card_issuing_disabled`	403 / 503	Feature flag