Skip to content

Операции платных подписок

Платные подписки позволяют аккаунтам предлагать многоуровневые периодические услуги с оплатой в токенах VIZ и опциональным автопродлением.


set_paid_subscription_operation (ID 50)

Авторизация: active account

Создаёт или обновляет предложение подписки. При первом создании взимается create_paid_subscription_fee.

ПолеТипОписание
accountaccount_name_typeАккаунт, предлагающий подписку
urlstringURL с деталями подписки
levelsuint16_tКоличество уровней подписки (≥ 1)
amountasset (VIZ)Базовая цена за период на единицу уровня
perioduint16_tПериод подписки в днях (≥ 1)
json
[50, {
  "account": "alice",
  "url": "https://alice.example.com/subscribe",
  "levels": 3,
  "amount": "10.000 VIZ",
  "period": 30
}]
  • Фактическая стоимость для подписчика = amount × level.
  • levels = 3 при amount = "10.000 VIZ" → уровень 1 стоит 10 VIZ, уровень 2 — 20 VIZ, уровень 3 — 30 VIZ за период.
  • Обновление операции изменяет параметры для будущих подписок; существующие активные подписки продолжаются на прежних условиях до продления.

Авторизация: active subscriber

Оформляет или продлевает платную подписку. Токены немедленно переводятся от subscriber к account.

ПолеТипОписание
subscriberaccount_name_typeПодписывающийся аккаунт
accountaccount_name_typeАккаунт, предлагающий подписку
leveluint16_tУровень подписки (1 – levels)
amountasset (VIZ)Сумма платежа
perioduint16_tКоличество оплачиваемых периодов
auto_renewalboolВключить автоматическое продление каждый период
json
[51, {
  "subscriber": "bob",
  "account": "alice",
  "level": 2,
  "amount": "20.000 VIZ",
  "period": 1,
  "auto_renewal": true
}]
  • amount должна точно совпадать с subscription.amount × level × period.
  • level должен быть в диапазоне [1, subscription.levels].
  • auto_renewal: true — токены автоматически списываются каждый период при наличии достаточного баланса.
  • auto_renewal: false — разовая подписка; истекает после оплаченного периода.

Виртуальные операции:

Виртуальная операцияТриггер
paid_subscription_action_operationПлатёж обработан
cancel_paid_subscription_operationПодписка истекла или отменена

См. также: Типы данных, Обзор операций, Виртуальные операции.