payg_topup_required — нужен PAYG-добор
Что произошло
Заказ не создан и деньги не списаны — сервер вместо этого прислал цену доплаты. Тело: reason: "payg_topup_required", shortfall_tokens, shortfall_lmc, shortfall_lmc_minor, quote_token, expires_at.
Почему
Заказ стоит больше, чем осталось токенов в квоте подписки, но сервис разрешает pay-as-you-go (Service.payg_access ≠ disabled). Это развилка оплаты, а не отказ ключа и не лимит: сервер спрашивает согласия на списание недостающей части из LMC-баланса.
Что сделать прямо сейчас
Показать пользователю shortfall_lmc и получить явное согласие — автоматический ретрай здесь означает молчаливое списание денег. Котировка живёт недолго (expires_at, порядка минуты); если истекла, повторный запрос БЕЗ подтверждения вернёт свежий 402 с новым quote_token.
Какой запрос отправить следующим
Тот же POST /orders с тем же телом плюс "confirm_payg_topup": true и "quote_token" из этого ответа → 201, доплата спишется из LMC. Если за это время цена выросла — придёт 409 quote_mismatch. Разбивка по факту потом видна в заказе: tokens_from_quota и tokens_from_payg.
Куда идти дальше
Скормить страницу ИИ
спека 0.0.1