Дайте клиентам кредиты и назначьте операциям цену в них

Кредиты — это единица, в которой вы считаете потребление своих клиентов. Slen ведёт баланс кредитов для каждого клиента, берёт кредиты, когда флоу выполняется для него, и отклоняет запуск, который баланс не покрывает. Эта статья — о странице клиентов в консоли.

Как работают кредиты

Клиент — это ваш конечный клиент. Slen знает клиента по идентификатору, который ему даёт ваше приложение, — тому, что запрос, запускающий флоу, отправляет в context.user_id. Используйте идентификатор вашей системы, а не адрес почты и не имя.

Операция получает цену в кредитах. Каждый вызов модели в запуске, который называет клиента, резервирует цену на счёте клиента до того, как модель вызвана. Кредиты тратятся, когда вызов рассчитан, и возвращаются, когда он не удался.

Кредиты — не деньги. Запуск, который резервирует кредиты, всё равно проверяется политиками и бюджетами.

У клиента может быть несколько счетов, по одному на каждый тип кредитов. Тип кредитов — это имя, которое вы выбираете сами. Запрос, который запускает флоу, называет его в context.credit_type, а запрос, который его не называет, использует default. Цена ищется для операции и типа кредитов, поэтому тип кредитов, у которого нет цены для операции, кредитов не берёт.

Ваше приложение может и само снимать кредиты — за то, что оно продаёт вне флоу: выгрузку, место. Такое списание делается через API — Клиенты и кредиты. Консоль не списывает.

Где клиенты

Откройте Клиенты. Страница показывает клиентов проекта, выбранного в шапке. Три вкладки под заголовком выбирают, что страница показывает: Клиенты, Маржа или Цены кредитов.

Добавить клиента

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

Клиент появляется и тогда, когда ваше приложение впервые пополняет его через API.

Прочитать список

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

• Баланс — это то, что есть у клиента. Зарезервированные кредиты отложены под вызовы, которые ещё не закончились. Доступное — это баланс без зарезервированных кредитов, поэтому баланс — это обе суммы вместе.

• Поиск оставляет клиентов, чей идентификатор содержит введённый текст.

• Доступно меньше сужает список до клиентов, у которых есть счёт, где доступно меньше кредитов, чем введённое число. Зарезервированные кредиты при этом не считаются доступными.

• Фильтры рядом оставляют активных или заблокированных клиентов и клиентов со счётом одного типа кредитов.

Нажмите на строку, чтобы открыть карточку клиента. Карточка перечисляет счета с их суммами и настройками, а Движение под ними перечисляет движения кредитов клиента. Меню строки ведёт сразу к действиям Пополнить, Заблокировать и Удалить.

Настроить счёт

Счёт принадлежит одному типу кредитов. Его создаёт первое пополнение или его настройки, поэтому клиенту можно дать счёт раньше любых кредитов.

Пополнить клиента

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

Скорректировать баланс

В карточке нажмите Скорректировать в счёте. В поле Сколько кредитов добавить или снять введите, сколько кредитов добавить, или отрицательную сумму, чтобы снять кредиты, при желании заполните Примечание и нажмите Применить корректировку. Нулевая сумма отклоняется.

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

Прочитать выписку

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

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

Заблокировать клиента

Заблокируйте клиента, чтобы остановить его запуски, например после возврата платежа.

Новый запуск заблокированного клиента отклоняется с кодом customer_blocked до того, как что-либо создано. Его запуск, который уже идёт, отклоняется на следующем холде кредитов. Запуск операции без цены не резервирует кредиты и доходит до конца. У заблокированного клиента по-прежнему можно пополнять, списывать и корректировать кредиты, менять настройки и читать выписку, поэтому с клиентом можно рассчитаться.

Чтобы снова пустить клиента, нажмите Разблокировать в карточке. Разблокировать в меню строки открывает карточку.

Удалить клиента

В карточке нажмите Удалить или выберите Удалить в меню строки, затем нажмите Удалить клиента. Удаляется только клиент без истории: каждый счёт на нуле, ничего не зарезервировано, и в выписке нет ни одного движения. Клиент и его пустые счета исчезают.

Клиент с историей остаётся, потому что выписка объясняет баланс. Карточка объясняет почему и предлагает вместо этого заблокировать клиента. Через API тот же отказ — это код customer_has_history.

Назначить цену операции

Новая цена действует со следующего холда. Вызов, который уже зарезервировал кредиты, сохраняет цену, по которой их зарезервировал, и каждый вызов модели в запуске резервирует цену один раз.

Сравнить кредиты со стоимостью

Маржа показывает за выбранный период, сколько кредитов списано с каждого клиента и сколько те же вызовы стоили в деньгах. Считаются только рассчитанные вызовы, и списание вашего приложения среди них не учитывается. Две суммы — в разных единицах, поэтому страница не показывает их соотношение.

Что читать дальше

• Глоссарий — клиент, счёт, кредиты, списание и блокировка, по одной строке на каждое.

• Политики — политика может применяться к вызовам одного клиента.

• Клиенты и кредиты — клиенты, счета, пополнения, списания, блокировка и цены через API.

• Клиенты и кредиты — те же клиенты из SDK и запуск, оплаченный кредитами клиента.

• Управление API-ключами — ключ, которым ваше приложение ведёт своих клиентов.

• Коды ошибок — каждый код API: что он значит и что с ним делать.