---
title: "payg_topup_required — нужен PAYG-добор"
url: https://lumean.app/developers/docs/errors/payg-topup-required
locale: ru
description: "Заказ не создан и деньги не списаны — сервер вместо этого прислал цену доплаты. Тело: `reason: \"payg_topup_required\"`, `shortfall_tokens`, `shortfall_lmc`, `shortfall_lmc_minor`, `quote_token`, `expires_at`."
generated: 2026-10-17
---

# payg_topup_required — нужен PAYG-добор

- HTTP: `402`

- `reason`: `payg_topup_required`

- Заголовок `Retry-After`: нет

## Что произошло

Заказ не создан и деньги не списаны — сервер вместо этого прислал цену доплаты. Тело: `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`.

## Смежное

- [quote_mismatch — котировка подорожала](https://lumean.app/developers/docs/errors/quote-mismatch)
- [insufficient_allowance — если PAYG отключён](https://lumean.app/developers/docs/errors/insufficient-allowance)
- [Гайд: LMC, квоты и PAYG](https://lumean.app/developers/docs/guide/billing)
- [POST /orders](https://lumean.app/developers/docs/api/post-orders)
- [POST /orders/{order}/retry](https://lumean.app/developers/docs/api/post-orders-order-retry)
- [GET /subscriptions](https://lumean.app/developers/docs/api/get-subscriptions)
- [Кошелёк](https://lumean.app/wallet)
- [Тарифы](https://lumean.app/shop)

---

- Эта же страница в браузере: https://lumean.app/developers/docs/errors/payg-topup-required
- Машинный справочник целиком: https://api.lumean.app/docs/llm.md