Создание подписки

Функционал доступен только по согласованию со Службой безопасности. Для подключения подписок обратитесь в службу поддержки.

---

Механизм подписок позволяет автоматически списывать средства с карты клиента без его участия. Используется для регулярных платежей, например:

• аренда,

• интернет,

• мобильная связь,

• другие периодические услуги.

На данный момент подписки поддерживаются для методов card tinkoffpay (T-Pay) и sbp (СБП).

---

Шаг 1. Создание установочного платежа

При инициации первого платежа необходимо передать параметр subscription, чтобы привязать карту к подписке:

• При создании через форму: subscription=true

• При создании через API: params[subscription]=true

📌 Рекомендуется также передать параметр hideOtherMethods=true, чтобы скрыть другие способы оплаты и зафиксировать метод card.

На этом этапе вы можете добавить параметр preauth=1, чтобы сформировать платеж с преавторизацией. Для автоматической отмены платежа укажите в запросе preauthExpireLogic=1.

Подробнее тут.

Шаг 2. Получение идентификатора подписки

После успешного установочного платежа, ваш обработчик должен получить параметр:

subscriptionId = <значение>

Этот ID нужно сохранить — он будет использоваться для всех последующих автосписаний.

Шаг 3. Списание по подписке

Чтобы провести автосписание:

• Убедитесь, что подписка имеет статус active;

• Используйте обычный метод создания платежа через API;

• Передайте subscriptionId в параметре:

params[subscriptionId]=<значение>

Сумма и периодичность автосписаний — на вашей стороне. Их задаёт ваша система.

---

Списание по подписке несовместимо с двухстадийными платежами (платежами с преавторизацией). Преавторизация возможна только на этапе создания установочного платежа (шаг 1).

Возврат установочного платежа

Если вы продаёте подписку с бесплатным первым месяцем, может потребоваться сначала списать с клиента небольшую сумму, а затем вернуть её — например, для проверки карты или создания подписки.

Подписки в Unitpay не имеют автоматический возврат установочного платежа. Но вы можете вернуть установочный платёж сами через метод возврата платежа передав ему в параметре paymentId значение unitpayId, полученного при установочном платеже.