| invalid_json | 400 | No | Request body is malformed JSON. |
| missing_idempotency_key | 400 | No | Idempotency-Key header is required on POST /v1/orders. |
| invalid_idempotency_key | 400 | No | Idempotency-Key must be 16..64 characters matching [A-Za-z0-9_.:-] without leading/trailing whitespace. |
| missing_api_key | 401 | No | Missing Authorization: Bearer <key> or X-Api-Key header. |
| invalid_api_key | 401 | No | API key format is invalid or credentials could not be verified. |
| api_key_revoked | 401 | No | This API key has been revoked. |
| api_key_inactive | 401 | No | This API key is currently inactive. |
| api_key_expired | 401 | No | This API key has passed its expiration timestamp. |
| insufficient_wallet_balance | 402 | No | Available prepaid NGN wallet balance is below total_price_kobo. Fund the wallet and retry. |
| ip_not_whitelisted | 403 | No | Caller IP address is not included in this API key CIDR allowlist. |
| insufficient_scope | 403 | No | This API key does not have the required scope for the endpoint. |
| client_suspended | 403 | No | Partner organization is suspended or not active for live API requests. |
| client_not_found | 403 | No | Partner organization record could not be located. |
| product_not_enabled | 403 | No | Requested product_id is not enabled on this partner catalog allowlist. |
| not_found | 404 | No | Requested /v1 endpoint does not exist. |
| order_not_found | 404 | No | No order with the specified id or client_reference exists for this partner and key mode. |
| wallet_not_found | 404 | No | Prepaid wallet record not found for this partner organization. |
| client_reference_conflict | 409 | No | client_reference was already committed with a different product_id, account_id, zone_id, or quantity. |
| payload_too_large | 413 | No | Request body exceeds the 16 KB limit. |
| unsupported_media_type | 415 | No | POST requests must send Content-Type: application/json. |
| validation_error | 422 | No | One or more request parameters failed schema validation (see details). |
| idempotency_key_payload_mismatch | 422 | No | Idempotency-Key was already used for a different HTTP method, route, or request body. |
| idempotency_in_recovery | 422 | Yes | An earlier attempt with this Idempotency-Key left an incomplete idempotency state; retry shortly or inspect the order by client_reference. |
| idempotency_key_already_used | 422 | No | Idempotency-Key was already consumed by a committed order. |
| product_not_b2b_eligible | 422 | No | Requested product_id is not available for automated API ordering. |
| invalid_recipient | 422 | No | account_id or zone_id does not satisfy recipient rules for the selected product. |
| order_exceeds_max_value | 422 | No | Calculated total_price_kobo exceeds the organization per-order limit. |
| missing_player_id | 422 | No | player_id is required when calling POST /v1/players/verify. |
| invalid_cursor | 422 | No | Pagination cursor is malformed or tampered. |
| webhook_not_configured | 422 | No | No webhook_url is configured for this partner organization. |
| invalid_webhook_url | 422 | No | Configured webhook_url failed HTTPS or SSRF destination validation. |
| invalid_kobo_amount | 422 | No | Monetary amount failed integer-kobo validation. |
| kobo_overflow | 422 | No | Calculated monetary amount exceeded safe integer kobo bounds. |
| rate_limit_exceeded | 429 | Yes | API key or caller IP exceeded its token-bucket request quota. Honor the Retry-After header. |
| auth_throttled | 429 | Yes | Too many failed authentication attempts from this IP/key prefix within 60 seconds. Honor Retry-After. |
| daily_spend_limit_exceeded | 429 | No | Order would exceed the partner organization net daily spend limit (resets at 00:00 WAT). |
| product_unavailable | 503 | Yes | Requested product is temporarily unavailable for API ordering. Honor the Retry-After header (300s). |
| provider_unavailable | 503 | Yes | Upstream fulfillment capacity is temporarily unavailable. Safe to retry with backoff. |
| catalog_unavailable | 503 | Yes | Product metadata service is temporarily unavailable and no cached entry exists. |
| verification_unavailable | 503 | Yes | Player verification upstream service or circuit breaker is temporarily unavailable. |
| system_maintenance | 503 | Yes | B2B order creation is temporarily paused for scheduled maintenance. |
| codm_routing_disabled | 503 | Yes | Automated delivery for this Call of Duty: Mobile SKU is temporarily paused. |
| b2b_unavailable | 503 | Yes | B2B runtime is unconfigured or failing readiness checks on this instance. |
| server_draining | 503 | Yes | Instance is shutting down and not accepting new orders. Safe to retry with the same Idempotency-Key. |
| service_unavailable | 503 | Yes | Service is temporarily unavailable. |
| db_timeout | 503 | Yes | Database statement timed out. Safe to retry idempotently. |
| db_tx_timeout | 503 | Yes | Database transaction timed out. Safe to retry idempotently. |
| db_lock_timeout | 503 | Yes | Wallet lock contention timeout. Safe to retry idempotently after a short delay. |
| db_busy | 503 | Yes | Database connection pool or transient serialization retry busy. |
| db_unavailable | 503 | Yes | Database connection was interrupted or unavailable. |
| internal_error | 500 | No | An unexpected internal error occurred. Contact partner support with request_id. |