Как настроить продукты подписки и группы планов

Продукт подписки — это услуга или пакет услуг, предоставляемые пользователю по подписке. Создание продуктов необходимо, если вы настраиваете продажу подписок на разные услуги или хотите дать пользователю возможность оформлять несколько подписок одновременно. Пример продукта подписки — доступ к каналу стримера, к игре, к уникальному предмету/уникальной способности.

Группа планов — набор планов, которые имеют одинаковое значение параметра group_id. Параметр group_id используется для формирования группы планов и связи этой группы с продуктами подписки. Создание группы планов позволяет:

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

Группы, планы и продукты взаимодействуют между собой согласно правилам:

• Один план может быть привязан только к одной группе.
• Один продукт может быть создан на основе только одной группы.
• Одна группа может быть привязана к нескольким продуктам.

Чтобы создать продукт подписки и группу планов, передайте в метод Создание продукта параметры:

• name c названием продукта;
• group_id с названием группы планов.

Для изменения, удаления или получения списка всех продуктов используйте соответствующие методы API:

• Изменение продукта
• Удаление продукта

• Список продуктов

Чтобы привязать план к группе планов и к продукту, передайте в метод Обновление плана параметр group_id с названием группы планов. Для удаления группы передайте “group_id”:null.

Для открытия платежного интерфейса при покупке плана, привязанного к продукту, передайте в метод Создание токена параметры:

• purchase.subscription.plan_id с ID плана;

• purchase.subscription.product_id ID продукта, связанного с планом через group_id.

Примеры

• Вы хотите продавать доступ к игре только с одним вариантом условий подписки, вам необходимо настроить только план подписки. Продукт в этом случае настраивать не требуется.
• Вы хотите продавать доступ к игре на разных условиях, например на 1 месяц и на 3 месяца, вам необходимо настроить 2 плана подписки с соответствующими условиями. Продукт в этом случае настраивать также не требуется. Планы по умолчанию будут иметь параметр “group_id”:null, то есть будут находиться в общей группе. Пользователь сможет выбирать любой из них при покупке подписки, а также переходить с одного плана на другой.
• Вы хотите продавать не только доступ к игре на 1 и на 3 месяца, но и дополнительную подписку, например на апгрейд меча на 6 месяцев. В этом случае:
  1. Создайте 2 продукта “игра” и “меч”, передав в метод Создание продукта уникальные параметры name и group_id для каждого продукта.
  2. Создайте планы на 1, 3 и 6 месяцев одним из способов:
     • Настройте планы в Личном кабинете, затем с помощью метода Обновление плана передайте параметр group_id продукта “игра” в планы подписки для продажи игры и параметр group_id продукта “меч” в планы подписки для продажи меча.
     • Используйте метод API Создание плана, в котором передайте данные о планах, а также параметр group_id продукта “игра” в планы подписки для продажи игры и параметр group_id продукта “меч” в планы подписки для продажи меча.
  3. Реализуйте отображение товаров “подписка на игру” и “подписка на апгрейд меча” в интерфейсе магазина.

Последнее обновление: 22 января 2024