Skip to content

Постоплата

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

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

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

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

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

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

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

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

Если раздел 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
id integer <int32> Идентификатор проекта.
Request Body Schema
IsPostPaid boolean Параметр, с помощью которого можно включить (True) или выключить(False) опцию постоплаты.
MaxDebt number <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"
    }
  }
}