Каждая ошибка API приходит с коротким кодом и понятным сообщением. Вот те, с которыми мерчанты сталкиваются чаще всего.
Ключи и доступ
- unauthenticated / invalid_credentials: ключ проекта или секрет отсутствует либо неверен. Проверьте, нет ли лишних пробелов и что секрет относится именно к этому проекту.
- project_inactive: вы использовали боевой секрет до одобрения проекта. До одобрения используйте тестовый секрет, см. Проверка проекта: что и когда проверяем.
- project_disabled: проект приостановлен или не одобрен.
- ip_not_allowed: вызов пришёл с адреса, которого нет в белом списке IP для API этого проекта.
Ваш запрос
- invalid_request: поле отсутствует или заполнено в неверном формате. В сообщении указано, какое именно.
- duplicate_order_id: платёж с таким order ID уже существует в этом режиме. Используйте новый или найдите существующий платёж.
- insufficient_funds: баланса не хватает для покупки скина. В сообщении указано, сколько нужно.
Лимиты запросов
Проект может делать до 600 вызовов в минуту. Сверх этого вы получите rate_limited с подсказкой, когда повторить. Подождите, а не повторяйте запрос в плотном цикле.
Когда рынок перегружен
Если платёжная сеть не отвечает, вы получите сообщение с просьбой повторить через минуту. Order ID и custom ID уникальны в пределах проекта, поэтому повтор никогда не создаст второй платёж или покупку. Повторный вызов покупки с тем же custom ID вернёт уже существующую покупку.
Полный список ошибок, полей и примеров — в справочнике API.