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

**Функционал доступен только по согласованию со Службой безопасности.**\
Для подключения подписок обратитесь в [службу поддержки](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): `params[subscription]=true`

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

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

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

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

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

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

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

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

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

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

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

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

***

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

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

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

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.unitpay.ru/payments/recurring-payments/create-subscription.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.