Формат ошибки
Любая ошибка возвращается с соответствующим HTTP-статусом и телом:
{"message": "Краткое описание ошибки."}
Коды
| Поле | Тип | Описание |
|---|---|---|
401опц. | Unauthorized | Отсутствует или неверный заголовок X-Api-Key. |
403опц. | Forbidden | Мерчант отключён, не может принимать платежи, либо не задан callback_url. |
404опц. | Not Found | Объект с указанным uuid или external_id не найден. |
409опц. | Conflict | Конфликт идемпотентности выплаты по external_id. |
422опц. | Unprocessable Entity | Ошибка валидации тела запроса (см. поле errors), недопустимый callback_url, нехватка баланса для выплаты. |
429опц. | Too Many Requests | Превышен лимит запросов (rate limit) по ключу или IP. |
502опц. | Bad Gateway | Ошибка платёжного провайдера при инициации платежа или получении H2H-реквизитов. |
Обработка 429
При 429 Too Many Requests снизьте частоту и повторите запрос позже. Учитывайте заголовокRetry-After, если он присутствует. Лимиты считаются по API-ключу и по IP одновременно.
Повторные попытки
5xxи сетевые сбои — безопасно повторять с тем же external_id.4xx(кроме429) — повтор не поможет, исправьте запрос.- Используйте экспоненциальную задержку между повторами.