402 — требуется оплата

Заказ не создан и деньги не списаны. Код приходит на POST /orders и на POST /orders/{order}/retry — они проходят один и тот же биллинг-flow. В теле обязателен reason, и именно от него зависит, ошибка это или предложение доплатить.

Под кодом 402 живут три разных случая. payg_topup_required — квоты подписки не хватило, но сервис разрешает pay-as-you-go: это развилка оплаты, а не отказ. insufficient_balance — не хватает LMC на балансе. insufficient_allowance — квоты не хватило, а PAYG у сервиса отключён, доплатить нельзя.

Ветвиться по reason, а не по message: формулировки сообщений меняются без предупреждения и кодом ошибки не являются. Не ретраить вслепую: повтор без подтверждения выдаст свежий 402 с новым quote_token, а слепой повтор С подтверждением спишет деньги без ведома пользователя.

GET /subscriptions — остаток квоты в items[].tokens_remaining. Если остаток нулевой, а reason был payg_topup_required, следующий шаг — подтверждённый добор (см. страницу кода).

• payg_topup_required — предложение доплатить
• insufficient_balance — не хватает LMC
• insufficient_allowance — PAYG отключён
• Гайд: LMC, квоты и PAYG
• POST /orders
• Кошелёк
• Тарифы