---
title: Оплата
description: Кошелёк организации, пополнение через платёжную систему, закреплённый курс, из чего складывается списание и что отвечает вызов на пустом кошельке.
keywords: оплата, кошелёк, баланс, пополнение, курс, списание, движения средств, 402
group: account
---

## Пополните кошелёк {#top-up keywords="пополнение, платёж, карта, сбп, рубли"}

:::steps
- **Откройте баланс в консоли** — Кошелёк там же, где ключи.
- **Выберите способ оплаты** — Карта, СБП или криптовалюта; какие из трёх предложены, решает счёт платёжной системы. Выбор самой системы появляется, только когда их предложено больше одной.
- **Назовите сумму в рублях** — Любая сумма больше нуля, минимума нет.
- **Сверьте обе суммы и платите** — Консоль показывает, сколько вы получите и сколько с вас спишут, до перехода на страницу оплаты.
:::

Пока вы не ушли на страницу оплаты, не списано ничего. Закрыть окно можно без потерь: платёж останется в истории и будет ждать, пока его не оплатят, не отменят или он не просрочится.

## Кошелёк {#wallet keywords="кошелёк, баланс, доступно, удержано, организация"}

Кошелёк принадлежит **организации**, а не пользователю, и ключ, который тратит с баланса, тратит именно его. Учётная единица одна — доллар США, и она не меняется вместе с переключателем валюты отображения в настройках.

Баланс кошелька — это не одно число, а несколько, и путать их дорого.

:::deflist
| Величина | Что это |
| --- | --- |
| Доступно к тратам | **Расчётный баланс минус оба удержания.** Это и есть та величина, по которой вызов проходит или не проходит. |
| Удержано запросами в работе | Деньги под вызовы, которые ещё не завершились. |
| Удержано под возврат | Деньги под возвраты, которые ещё идут. |
| Начислено за всё время | Всё, что когда-либо зачислялось. |
| Списано за всё время | Всё, что когда-либо списывал расчёт. |
:::

Удержание — не списание. Вызов сначала резервирует оценку своей стоимости, а по завершении расчёт заменяет её фактом; если вызов стоил меньше, чем удерживал, разница возвращается отдельным движением.

## Как проходит платёж {#payment keywords="платёжная система, способ оплаты, страница оплаты, отмена, статус"}

Платёж создаётся у выбранной платёжной системы и уводит вас на её страницу оплаты. Список систем публикует платформа: их названия задаёт оператор, и какие способы принимает счёт каждой из них — тоже её свойство, а не ваше.

Страница оплаты закрывается по времени; консоль показывает, когда. У платежа при этом собственная жизнь, и она видна в истории платежей:

- **ожидает оплаты** — создан, деньги не тронуты;
- **оплачен, зачисляем** — деньги пришли, зачисление идёт; обычно это меньше минуты;
- **зачислено** — баланс пополнен;
- **отменён**, **отклонён банком**, **просрочен** — списания не было;
- **на проверке** — до её окончания не зачисляется ничего;
- **возвращён** — платёж вернули, поэтому не зачислено ничего.

Неоплаченный платёж можно отменить самому. Платёж, который платёжная система уже приняла, не отменяется — этот случай решает поддержка.

:::note
Повтор одной и той же попытки создания платежа не создаёт второго платежа и не может списать дважды: платформа отвечает тем же самым платежом. Именно поэтому на неответившую платёжную систему правильный ход — повторить, а не начинать заново.
:::

## Курс {#rate keywords="курс, рубли, доллары, наценка, цб"}

Курсов два, и они не взаимозаменяемы.

- **Курс платежа** закрепляется в момент создания платежа и относится только к нему. По нему считается, сколько рублей с вас возьмут за покупаемую долларовую величину, и он несёт наценку чекаута. Обе суммы показаны до перехода к оплате.
- **Учётный курс** — курс Банка России, и он только для показа. Наценки в нём нет, и платёж по нему не считается: это то, чем консоль пересчитывает баланс, когда вы просите показать его в рублях.

Оплата в любом случае проходит в рублях, а на кошельке лежат доллары.

## Из чего складывается списание {#charging keywords="ставка, списание, измерения, токены, изображения, прайс"}

Списывается каждый вызов, и считается он по **измерениям** — по тому, что вызов действительно потребил. Их пять, и словарь закрыт:

- входные токены по полной ставке;
- входные токены, прочитанные из кеша;
- входные токены, записанные в кеш;
- выходные токены;
- единицы изображений.

У кошелька каждое измерение имеет **цену за единицу** в опубликованном прайс-листе. Измерение может быть бесплатным или неприменимым к этой модели — тогда цены у него нет вовсе, и это разные вещи, а не два способа написать ноль.

Считается списание по прайс-листу, **действующему на момент запроса**. Версия прайса, показанная у покупки в консоли, — это неизменяемый след аудита, а не цена, по которой вас посчитают потом.

Сами цены живут не здесь: их публикует [прайс-лист](https://kumorouter.com/ru/pricing), а идентификаторы моделей — сам шлюз по адресу `https://api.kumorouter.com/v1/models`.

> [Пакеты вместо кошелька →](/ru/packages) [Где посмотреть свой расход →](/ru/usage)

## Когда платить нечем {#refusals keywords="402, пустой кошелёк, отказ, лимит трат, заморожена"}

Кошелёк, которому нечем оплатить вызов, отвечает **`402`** с кодом `insufficient_wallet_balance`. Отказ решается до обращения к провайдеру, поэтому наверху такого вызова не видели, и денег он не стоил.

Отличайте его от соседей — у них другие статусы и другое лечение.

:::matrix
| Отказ | Статус | Что лечит |
| --- | --- | --- |
| Кошельку нечем платить | `402` | пополнение |
| Потолок трат за сутки или месяц | `429` | время |
| Потолок трат за всё время или на один запрос | `429` | разговор с поддержкой |
| Организация заморожена | `403` | разговор с поддержкой |
:::

`402` от потолка трат отличается тем, что второй наступает при живых деньгах: потолок — это ограничение, которое вы себе поставили, а не отсутствие средств.

> [Все статусы шлюза →](/ru/errors) [Потолки темпа →](/ru/limits)

## Движения средств {#ledger keywords="движения, история, приход, расход, удержано, леджер"}

«Движения средств» в консоли — это неизменяемая история денег организации, новые сверху. Каждое движение записано **в той единице, в которой оно на самом деле произошло**: кошельковые в долларах, пакетные в токенах пакета. Это две отдельные колонки, потому что это две разные единицы, и одна в другую не переводится.

Движения идут по трём балансам, и каждый воспроизводится суммированием только своей части.

| Баланс | Что в нём |
| --- | --- |
| `Доступный` | То, что можно потратить. Двигается приходом и расходом. |
| `Долг` | Обязательство. Суммируется с обратным знаком. |
| `Удержано` | Резервы под вызовы и возвраты. Двигается удержанием и возвратом удержания. |

Причина у каждого движения названа словами: платёж зачислен, вызов рассчитан, возврат, возник или погашен долг, вызов стоил меньше, чем удерживал. Удержание и его последующий возврат — это два движения одного факта, а не одно.

Фильтры сужают список по балансу, направлению и причине. Короткая версия той же таблицы есть и на экране баланса — там же лежит выгрузка в CSV.

Окно ограничено: один запрос покрывает не больше 366 дней. Движения хранятся **пять лет**, поэтому более старый период читается сдвигом окна назад, а не его расширением.

> [Сколько потратил каждый ключ →](/ru/usage) [Что происходит при нехватке средств →](/ru/errors)