Перейти к основному содержимому

Постоплата

Постоплата (PostPaid) — опция, которая позволяет потреблять ресурсы в панели управления в рамках выданного депозита без пополнения баланса.

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

Правила работы постоплаты

Если опция постоплаты включена для проекта:

  • Блокировка по балансу осуществляется при достижении суммы -MaxDebt (максимальный разрешенный отрицательный баланс, при превышении которого проект будет заблокирован.), разблокирование происходит в случае, если сумма увеличивается до значения больше -MaxDebt.
  • Задачи на блокировку или разблокировку по балансу могут генерироваться также при редактировании полей IsPostPaid и MaxDebt в административной панели, редактировании через API.
  • Вкладка Обещанный платёж недоступна.
  • Баланс показывается в обычном виде. Если баланс положительный, отображается текущий остаток на балансе, если баланс отрицательный, показывается сумма со знаком минус. Текст "хватит на..." не показывается.
  • Все проверки в биллинге, нотификациях и т. д. происходят не с 0, а с суммой MaxDebt.
  • В тексте нотификаций не используются формулировки: "Ваш баланс ..."
  • Автовыставление счёта генерирует счёт на сумму долга.
  • При создании проекта поля IsPostPaid и MaxDebt заполняются значениями по умолчанию из настроек фичи.
  • Автоматическая выдача тестового баланса постоплаты пользователям не предусмотрена.

Включение для партнёра

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

1. В административной панели перейдите в раздел Features вкладки Партнёры. В фильтре выберите услугу Postpaid. В открывшемся списке выберите партнёра.

[INFO]

Если раздел Features недоступен, то, возможно:

  • У вас нет необходимой роли. Обратитесь к администратору для назначения соотвествующей роли и расширения привилегий.
  • Управление разделом Features находится в зоне вендора. Для включения опции постоплаты обратитесь к вендору через партнёрский канал.
Рисунок 1. Фичи партнёра

2. В окне справа откроется карточка фичи, на ней нажмите Изменить конфиг.

Рисунок 2. Карточка фичи

3. В открывшемся окне измените конфигурацию фичи. По примеру представленной JSON схемы заполните параметы IsPostPaidDefaultValue (при значении True постоплата включается по умолчанию для всех проектов партнёра, при значении False постоплата включается отдельно) и MaxDebtDefaultValue (сумма отрицательного порога по умолчанию, при достижении которого проект будет заблокирован). Нажмите Изменить.

Рисунок 3. Изменение конфига фичи

4. На карточке фичи нажмите Изменить состояние и переведите фичу в состояние Active. Нажмите Изменить.

Рисунок 4. Изменение состояния фичи Рисунок 5. Изменение состояния фичи

Включение для проекта

1. В административной панели перейдите на вкладку Проекты и выберите нужный проект.

Рисунок 6. Проекты

2. Далее на карточке проекта нажмите кнопку Постоплата. Выберите размер депозита (отрицательный порог, при достижении которого проект будет заблокирован) и нажмите на галочку Включить постоплату. Кликните Сохранить.

Рисунок 7. Включение постоплаты Рисунок 8. Включение постоплаты

API

Редактирование параметров постоплаты для проекта также возможно с помощью партнёрского API. Используется метод PUT и URI /v2/projects/{id}.

Таблица 1. Параметры
НаименованиеТип данныхОписание
Path Parameters
idinteger <int32>Идентификатор проекта.
Request Body Schema
IsPostPaidbooleanПараметр, с помощью которого можно включить (True) или выключить(False) опцию постоплаты.
MaxDebtnumber <double>Максимальный разрешенный отрицательный баланс, при превышении которого проект будет заблокирован.
Пример запроса:
{
"IsPostPaid": true,
"MaxDebt": 12.34
}
Пример ответа:
{
"Result": {
"Project": {
"Id": 1311,
"State": "Active",
"Balance": 1098.3118356089,
"IsPaid": true,
"IsPostPaid": true,
"MaxDebt": 12.34,
"EndingBalanceDateUtc": "2024-10-29T15:03:17.389942Z",
"FirstPaymentDateUtc": "2024-08-02T14:59:14.8080579Z"
}
}
}