Основы

Ошибки

1. Формат

При ошибке возвращается HTTP-статус 4xx/5xx и объект error. Для ошибок валидации в details.fields — сообщения по полям.

json
{ "error": { "code": "validation_error", "message": "Проверьте введённые данные", "details": { "fields": { "amount": "Минимум 1 ₽" } } } }

2. Коды

HTTPcodeКогда
400validation_errorНеверные параметры запроса
401invalid_api_keyКлюч неверен или отозван
403merchant_inactive / forbiddenМерчант приостановлен, нет доступа к среде, проект не прошёл модерацию
404not_foundОбъект не найден в вашем проекте
409idempotency_in_progress / already_paidЗапрос уже выполняется / платёж уже оплачен
422insufficient_fundsНедостаточно доступных средств для вывода
422not_cancelableПлатёж нельзя отменить в текущем статусе
422tariff_missing / method_not_allowed / no_providerТариф не согласован, метод не разрешён, нет доступного провайдера
429rate_limitedПревышен лимит запросов (600 в минуту на ключ)
503provider_unavailableПровайдер временно недоступен — повторите позже