> For the complete documentation index, see [llms.txt](https://help.unitpay.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.unitpay.ru/payments/recurring-payments/create-subscription.md).

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

**Функционал доступен только по согласованию со Службой безопасности.**\
Для подключения подписок обратитесь в [службу поддержки](https://help.unitpay.ru/support).

***

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

* аренда,
* интернет,
* мобильная связь,
* другие периодические услуги.

{% hint style="info" %}
На данный момент подписки поддерживаются **для методов `card`**  `tinkoffpay` (T-Pay) и sbp (СБП).
{% endhint %}

***

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

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

* При создании через [форму](https://help.unitpay.ru/payments/create-payment-easy): `subscription=true`
* При создании через [API](https://help.unitpay.ru/payments/create-payment): `subscription=true`

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

{% hint style="info" %}
На этом этапе вы можете добавить параметр `preauth=1`, чтобы сформировать платеж с преавторизацией. Для автоматической отмены платежа укажите в запросе `preauthExpireLogic=0`.

Подробнее [тут](/payments/pre-authorization-payments.md).
{% endhint %}

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

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

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

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

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

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

* Убедитесь, что подписка имеет статус **`active`**;
* Используйте обычный метод [создания платежа через API](https://help.unitpay.ru/payments/create-payment);
* Передайте `subscriptionId` в параметре:

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

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

***

{% hint style="warning" %}
**Списание по подписке несовместимо с двухстадийными платежами** (платежами с преавторизацией). Преавторизация возможна только на этапе создания установочного платежа (шаг 1).
{% endhint %}

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

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

Подписки в Unitpay не имеют автоматический возврат установочного платежа. Но вы можете вернуть установочный платёж сами через [метод возврата платежа](https://help.unitpay.ru/payments/payment-refund) передав ему в параметре `paymentId` значение `unitpayId`, полученного при установочном платеже.