---
title: "payg_topup_required — PAYG top-up required"
url: https://lumean.app/tr/developers/docs/errors/payg-topup-required
locale: tr
description: "The order was not created and no money was charged — instead, the server sent the price of the top-up. Body: `reason: \"payg_topup_required\"`, `shortfall_tokens`, `shortfall_lmc`, `shortfall_lmc_minor`, `quote_token`, `expires_at`."
generated: 2026-10-17
---

# payg_topup_required — PAYG top-up required

- HTTP: `402`

- `reason`: `payg_topup_required`

- `Retry-After` başlığı: hayır

## Ne oldu

The order was not created and no money was charged — instead, the server sent the price of the top-up. Body: `reason: "payg_topup_required"`, `shortfall_tokens`, `shortfall_lmc`, `shortfall_lmc_minor`, `quote_token`, `expires_at`.

## Neden

The order costs more than the tokens remaining in the subscription quota, but the service allows pay-as-you-go (`Service.payg_access` ≠ `disabled`). This is a payment decision point, not a key refusal and not a limit: the server is asking for consent to charge the missing part to the LMC balance.

## Ne yapmalı

Show the user `shortfall_lmc` and get explicit consent — an automatic retry here means silently charging money. The quote is short-lived (`expires_at`, on the order of a minute); if it has expired, a repeat request WITHOUT confirmation returns a fresh 402 with a new `quote_token`.

## Sonraki istek

The same `POST /orders` with the same body plus `"confirm_payg_topup": true` and the `"quote_token"` from this response → 201, and the top-up is charged to LMC. If the price has gone up in the meantime, you get a 409 `quote_mismatch`. The actual split is visible in the order afterwards: `tokens_from_quota` and `tokens_from_payg`.

## İlgili

- [quote_mismatch — quote got more expensive](https://lumean.app/tr/developers/docs/errors/quote-mismatch)
- [insufficient_allowance — if PAYG is disabled](https://lumean.app/tr/developers/docs/errors/insufficient-allowance)
- [Guide: LMC, quotas, and PAYG](https://lumean.app/tr/developers/docs/guide/billing)
- [POST /orders](https://lumean.app/tr/developers/docs/api/post-orders)
- [POST /orders/{order}/retry](https://lumean.app/tr/developers/docs/api/post-orders-order-retry)
- [GET /subscriptions](https://lumean.app/tr/developers/docs/api/get-subscriptions)
- [Wallet](https://lumean.app/tr/wallet)
- [Plans](https://lumean.app/tr/shop)

---

- Bu sayfa tarayıcıda: https://lumean.app/tr/developers/docs/errors/payg-topup-required
- Makine tarafından okunabilir tam başvuru: https://api.lumean.app/docs/llm.md