ИнтеграцияОшибки
Ошибки
Конверт один на все отказы. Ветвитесь по code и reason; message написан для людей и может меняться.
Обновлено 26 сентября 2026 г. · 3 мин чтения
Конверт
{"error": {
"code": "insufficient_balance",
"reason": null,
"message": "Аванса не хватает…",
"details": {"required": "20.00", …},
"request_id": "req_5f0c2a9e…"
}}code— машинный код: ветвитесь по немуreason— уточнение у части кодовmessage— для людей, может менятьсяdetails— данные к отказуrequest_id— назовите его поддержке
Незнакомый код
Повторите с тем же reseller_ref или Idempotency-Key и назовите поддержке request_id.
Реестр кодов
200 принято401 · 403 доступ404 · 405 · 410 нет объекта409 конфликт или состояние4xx запрос не прошёл402 · 429 деньги и лимиты5xx наша сторона
Ключ и доступ7
401
unauthenticatedКлюч API не принят: нет ключа, он неверный или отозван
403
scope_missingУ ключа нет нужной области
403
ip_not_allowedАдрес запроса не входит в разрешённые для ключа
403
browser_not_allowedAPI вызывается только с сервера, не из браузера
403
account_suspendedАккаунт партнёра приостановлен — напишите в поддержку
410
claim_expiredСсылка выдачи ключа просрочена — запросите новую
reason:
unknown — ссылки нет или истекла410
claim_usedСсылка выдачи ключа уже использована — запросите новую
Запрос8
404
not_foundТакого адреса нет
405
method_not_allowedМетод не поддерживается этим адресом
411
length_requiredНужен заголовок
Content-Length413
body_too_largeТело запроса слишком большое
415
unsupported_media_typeТело запроса должно быть
application/json422
validation_errorЗапрос не прошёл проверку
reason:
duplicate_line — пара «товар + вариант» дваждыmax_units — единиц больше лимитаidempotency_key_required — нет Idempotency-Keynetwork — сети нет в списке (песочница)422
idempotency_conflictКлюч повтора уже использован с другим запросом
reason:
idempotency_key — ключ повтора с другим телом или объектомreseller_ref — ref с другим телом, прежний заказ — в details.order_id409
idempotency_in_progressТакой же запрос ещё выполняется — повторите позже
Заказ и товар8
404
product_not_foundТовар не найден или скрыт
409
not_available_via_apiЭтот товар через API не продаётся
409
variant_requiredУкажите вариант товара
422
empty_orderВ заказе нет позиций
409
out_of_stockНет в наличии
reason:пусто — нет в наличии
queue_full — очередь card_pay занятаone_per_order — card_pay по однойno_mailbox — нет почты под «новый аккаунт»below_floor — неприкосновенный остаток розницыreservation_lost — резерв ушёл, повторите409
new_account_unavailable«Новый аккаунт» доступен только для оплаты нашей картой
reason:
not_card_pay — «новый аккаунт» только у card_pay409
price_changedСумма выше
max_total_usd — перечитайте цену404
order_not_foundЗаказ не найден
Аванс и лимиты3
402
insufficient_balanceАванса не хватает — пополните и повторите с тем же
reseller_ref429
rate_limitedСлишком много запросов — повторите после
Retry-Afterreason:
keyordersactivationglobalwebhookчей лимит сработал429
daily_cap_reachedИсчерпан суточный лимит
reason:
orders — заказов за суткиspend — трат за суткиАктивации5
404
activation_not_foundАктивация не найдена
409
invalid_stateОбъект не в том состоянии для этого действия
reason:
not_pending — отменить можно только pendingпричины активаций — раздел «Активации»422
credential_invalidДанные клиента не подходят для этой активации
reason:формат данных клиента — раздел «Активации»
200
credential_warningДанные приняты, но формат непривычный — проверьте вставку
422
login_link_invalidСсылка входа не подходит
reason:
not_requestedbad_linkemptyСобытия и вебхук4
409
webhook_not_configuredАдрес вебхука не задан
422
webhook_url_invalidАдрес вебхука не прошёл проверку
reason:
not_httpsbad_portbad_urlprivate_addressunresolvableforbidden_host422
invalid_cursorКурсор не распознан
410
cursor_expiredКурсор старше срока хранения событий — начните заново без
afterСервис3
503
api_disabledAPI временно выключен
503
rate_unavailableКурс недоступен — повторите позже
500
internal_errorВнутренняя ошибка — повторите запрос с тем же ключом повтора
Пример отказа
Пример: Аванса не хватает
{
"reseller_ref": "ord-10483",
"items": [
{
"product_id": "3f6c0e7e-2b1d-4c1a-9a57-4d0f1b8e2c11",
"quantity": 1
}
]
}
{
"error": {
"code": "insufficient_balance",
"reason": null,
"message": "Аванса не хватает — пополните и повторите с тем же reseller_ref",
"details": {
"balance": "4.00",
"required": "20.00"
},
"request_id": "req_5f0c2a9e41d7b3a8"
}
}
Страница помогла?