Оплата
Кошелёк организации, пополнение через платёжную систему, закреплённый курс, из чего складывается списание и что отвечает вызов на пустом кошельке.
Пополните кошелёк
- Откройте баланс в консолиКошелёк там же, где ключи.
- Выберите способ оплатыКарта, СБП или криптовалюта; какие из трёх предложены, решает счёт платёжной системы. Выбор самой системы появляется, только когда их предложено больше одной.
- Назовите сумму в рубляхЛюбая сумма больше нуля, минимума нет.
- Сверьте обе суммы и платитеКонсоль показывает, сколько вы получите и сколько с вас спишут, до перехода на страницу оплаты.
Пока вы не ушли на страницу оплаты, не списано ничего. Закрыть окно можно без потерь: платёж останется в истории и будет ждать, пока его не оплатят, не отменят или он не просрочится.
Кошелёк
Кошелёк принадлежит организации, а не пользователю, и ключ, который тратит с баланса, тратит именно его. Учётная единица одна — доллар США, и она не меняется вместе с переключателем валюты отображения в настройках.
Баланс кошелька — это не одно число, а несколько, и путать их дорого.
Удержание — не списание. Вызов сначала резервирует оценку своей стоимости, а по завершении расчёт заменяет её фактом; если вызов стоил меньше, чем удерживал, разница возвращается отдельным движением.
Как проходит платёж
Платёж создаётся у выбранной платёжной системы и уводит вас на её страницу оплаты. Список систем публикует платформа: их названия задаёт оператор, и какие способы принимает счёт каждой из них — тоже её свойство, а не ваше.
Страница оплаты закрывается по времени; консоль показывает, когда. У платежа при этом собственная жизнь, и она видна в истории платежей:
- ожидает оплаты — создан, деньги не тронуты;
- оплачен, зачисляем — деньги пришли, зачисление идёт; обычно это меньше минуты;
- зачислено — баланс пополнен;
- отменён, отклонён банком, просрочен — списания не было;
- на проверке — до её окончания не зачисляется ничего;
- возвращён — платёж вернули, поэтому не зачислено ничего.
Неоплаченный платёж можно отменить самому. Платёж, который платёжная система уже приняла, не отменяется — этот случай решает поддержка.
Повтор одной и той же попытки создания платежа не создаёт второго платежа и не может списать дважды: платформа отвечает тем же самым платежом. Именно поэтому на неответившую платёжную систему правильный ход — повторить, а не начинать заново.
Курс
Курсов два, и они не взаимозаменяемы.
- Курс платежа закрепляется в момент создания платежа и относится только к нему. По нему считается, сколько рублей с вас возьмут за покупаемую долларовую величину, и он несёт наценку чекаута. Обе суммы показаны до перехода к оплате.
- Учётный курс — курс Банка России, и он только для показа. Наценки в нём нет, и платёж по нему не считается: это то, чем консоль пересчитывает баланс, когда вы просите показать его в рублях.
Оплата в любом случае проходит в рублях, а на кошельке лежат доллары.
Из чего складывается списание
Списывается каждый вызов, и считается он по измерениям — по тому, что вызов действительно потребил. Их пять, и словарь закрыт:
- входные токены по полной ставке;
- входные токены, прочитанные из кеша;
- входные токены, записанные в кеш;
- выходные токены;
- единицы изображений.
У кошелька каждое измерение имеет цену за единицу в опубликованном прайс-листе. Измерение может быть бесплатным или неприменимым к этой модели — тогда цены у него нет вовсе, и это разные вещи, а не два способа написать ноль.
Считается списание по прайс-листу, действующему на момент запроса. Версия прайса, показанная у покупки в консоли, — это неизменяемый след аудита, а не цена, по которой вас посчитают потом.
Сами цены живут не здесь: их публикует прайс-лист, а идентификаторы моделей — сам шлюз по адресу https://api.kumorouter.com/v1/models.
Пакеты вместо кошелька → Где посмотреть свой расход →
Когда платить нечем
Кошелёк, которому нечем оплатить вызов, отвечает `402` с кодом insufficient_wallet_balance. Отказ решается до обращения к провайдеру, поэтому наверху такого вызова не видели, и денег он не стоил.
Отличайте его от соседей — у них другие статусы и другое лечение.
| Отказ | Статус | Что лечит |
|---|---|---|
| Кошельку нечем платить | 402 | пополнение |
| Потолок трат за сутки или месяц | 429 | время |
| Потолок трат за всё время или на один запрос | 429 | разговор с поддержкой |
| Организация заморожена | 403 | разговор с поддержкой |
402 от потолка трат отличается тем, что второй наступает при живых деньгах: потолок — это ограничение, которое вы себе поставили, а не отсутствие средств.
Все статусы шлюза → Потолки темпа →
Движения средств
«Движения средств» в консоли — это неизменяемая история денег организации, новые сверху. Каждое движение записано в той единице, в которой оно на самом деле произошло: кошельковые в долларах, пакетные в токенах пакета. Это две отдельные колонки, потому что это две разные единицы, и одна в другую не переводится.
Движения идут по трём балансам, и каждый воспроизводится суммированием только своей части.
ДоступныйТо, что можно потратить. Двигается приходом и расходом.ДолгОбязательство. Суммируется с обратным знаком.УдержаноРезервы под вызовы и возвраты. Двигается удержанием и возвратом удержания.Причина у каждого движения названа словами: платёж зачислен, вызов рассчитан, возврат, возник или погашен долг, вызов стоил меньше, чем удерживал. Удержание и его последующий возврат — это два движения одного факта, а не одно.
Фильтры сужают список по балансу, направлению и причине. Короткая версия той же таблицы есть и на экране баланса — там же лежит выгрузка в CSV.
Окно ограничено: один запрос покрывает не больше 366 дней. Движения хранятся пять лет, поэтому более старый период читается сдвигом окна назад, а не его расширением.
Сколько потратил каждый ключ → Что происходит при нехватке средств →