Продукт и план
Продукт
Продукт объединяет несколько планов одной логической линейки (например, «Облачный офис» с тарифами Basic / Pro).
В админ-панели продукт выбирается в контексте раздела Планы (/plan/list?productId=...): сначала создайте или выберите продукт, затем создавайте планы, отфильтрованные по этому productId.
Через Merchant API продукт создаётся методом вроде productNew / правки productEdit (см. типы в @wilix/billbill-client-js).
Основной план (тип 1)
На экране создания/редактирования плана (/plan/new или /plan/:planId) задайте:
- название, описание, валюту;
- цену в минорных единицах;
- интервал (
intervalUnit,intervalCount); - при необходимости — пробный период, налог, отключение автосписания;
- привязку рекуррентных и разовых аддонов.
Сохраните план, затем активируйте и при необходимости опубликуйте (для отображения в пользовательских сценариях; для чисто API-интеграции уточните требования к publishStatus).
Аддоны
- Создайте отдельные планы с типом 2 (рекуррентный аддон) или 3 (разовый).
- На основном плане укажите их в списках привязанных аддонов.
- При создании подписки через API передайте выбранные аддоны в параметрах (
addonParams/ аналог в вашей версии API).
Проверка перед запуском
- Валюта плана согласована с настройками шлюза.
- Для подписок с автосписанием у плана не включено
disableAutoCharge(если нужен автосписок). - Налог
taxPercentageзадан в ожидаемом формате (см. Справочник).