insufficient_balance | 409 / 422 | No money/product document created; KYT uses 422 |
feature_disabled | 403 | Partner KYT channel is disabled |
billing_address_unavailable | 502 | Issuer address lookup failed; raw provider errors are not returned |
card_id_required / invalid_card_id | 400 | Missing / malformed card id (card_billing_address, card_transactions, card_unfreeze) |
ext_id_required | 400 | card_freeze / card_unfreeze missing ext_id |
ext_id_conflict | 409 | Same ext_id, different body |
product_unavailable | 409 | Card product not allowed for tenant |
offer_unavailable | 409 | Offer inactive / not sellable |
unknown_offer / offer_required | 422 | Bad / missing offer id |
invalid_address | 400 / 422 | Withdraw address |
invalid_amount / invalid_value | 400 / 422 | Amount rules |
invalid_quantity | 422 | quantity not in 1..20 |
invalid_cursor | 400 | Bad or foreign cursor (card_list). On card_transactions, also 0, a negative cursor, or a cursor from another card |
missing_required_field | 400 / 422 | Gift required fields |
catalog_stale | 503 | Refresh gift catalog and retry |
kyc_rejected / invalid_customer_data | 409 / 422 | Cardholder data (incl. ban_rus phone/country rules) |
cardholder_create_failed | 409 / terminal doc | Cardholder step failed with JSON body (not empty HTTP 500) |
issue_timeout | terminal doc / webhook | Stuck card_issue closed as failed; retry with new ext_id |
card_not_active / card_already_frozen | 409 | Card state |
card_frozen_by_platform | 409 | Unfreeze refused at accept time: IMBA (admin, operations, compliance, or an automatic freeze) already froze the card |
card_frozen_by_issuer | 409 | Unfreeze refused at accept time: the bank or card issuer already froze the card |
ext_id_too_long | 400 | card_unfreeze ext_id longer than 128 characters |
reason_too_long | 400 | card_unfreeze reason longer than 200 characters |
card_not_frozen | 409 | Unfreeze called on a card that is not frozen |
card_closed | 400 | Unfreeze called on a closed card |
invalid_status | 400 | card_transactions status is not pending, approved, or declined |
invalid_limit | 400 | card_transactions limit is not an integer of at least 1. Values above 100 are capped |
invalid_ts / invalid_range | 400 | from / to is not a timestamp, or from is after to |
invalid_json | 400 | Body is not JSON (card_billing_address, card_transactions, card_unfreeze). On card_transactions and card_unfreeze, a body larger than 8 KiB is the same code |
order_in_progress | 409 | Another card status change is still open |
unfreeze_not_confirmed | terminal document | The card was not active after the unfreeze attempt. This is also the result when IMBA or the issuer freezes the card while the request is in flight |
purchase_failed / provider_rejected | 409 | Provider could not fulfill |
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 | 409 | 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 |