Коды ошибок

Ответы об ошибке всегда имеют вид {"error": "текст"}.

HTTP	Когда	Что делать
`400`	Ошибка валидации (нет `custom_id`, неизвестный `product`, `quantity` вне диапазона, `callback_url` не https, неизвестный `gift_id`, неизвестный `code`, неверный формат `product_ref`, пропущены обязательные `fields` для игрового пополнения, сумма Steam в `quantity` меньше 50 или больше 50 000 ₽)	Исправьте тело запроса
`401`	Нет/неверный/отозванный ключ	Проверьте заголовок `Authorization`, при необходимости перевыпустите ключ
`402`	Недостаточно депозита при оплате (заказ → `rejected`)	Пополните депозит и создайте новый заказ
`404`	Заказ не найден	Проверьте `custom_id`
`409`	Заказ нельзя оплатить (уже отменён/отклонён)	Создайте новый заказ с новым `custom_id`
`429`	Превышен rate limit (~60 req/min)	Пауза по заголовку `Retry-After`, повтор
`503`	Товар временно недоступен	Повторите позже

FAQ

В каких единицах цены?
В рублях (*_rub). Дополнительно отдаём *_nano — целочисленные «нано» (1 ₽ = 1000 nano), для точных расчётов без плавающей точки.

Как считается цена Stars vs Premium?
Stars — цена за 1 звезду × quantity. Premium — фиксированная цена за пакет (quantity игнорируется, срок в коде: premium_3m/6m/12m).

Что если оплатил, а доставка не прошла?
Заказ перейдёт в failed, а списанный депозит вернётся на баланс автоматически.

Можно ли повторить оплату?
Да, pay идемпотентен по custom_id — повторный вызов не спишет депозит дважды, вернёт текущий статус.

Заказ завис в processing?
Обычно доставка занимает секунды-минуты. Если надолго завис — свяжитесь с поддержкой, мы сверим вручную (деньги не теряются).

Как узнать минимальную сумму заказа Stars?
quantity для Stars: от 50 до 1 000 000 звёзд.