# Endpoint: Немедленная отмена подписки

:::info
**С 1 ноября 2026 запрос без заголовка** `**X-Partner-Api-Key**` **перестанет работать.**

Мы добавили в эту ручку проверку владельца подписки: она сверяет, что подписка относится к вашему аккаунту. Чтобы проверка работала для ваших запросов, передавайте заголовок с вашим ключом — см. раздел «Заголовки» ниже.

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

:::

## Когда использовать этот метод

Этот метод подходит для случаев, когда подписку нужно отменить **немедленно** с мгновенным прекращением доступа.

**Типичные сценарии:**

* Пользователь запрашивает полный возврат средств
* Необходимо немедленно заблокировать доступ (нарушение правил, мошенничество)
* Пользователь хочет отменить подписку сразу после случайной оплаты
* Требуется prorate refund (возврат за неиспользованное время)

⚠️ **Важно:** При немедленной отмене доступ пользователя прекращается сразу, даже если период еще не закончился.


---

Для сравнения: [Отмена подписки в конце периода](https://docs.thenextgen.store/s/1fa79577-e778-443b-a4e4-187f47b93798/doc/endpoint-otmena-podpiski-v-konce-perioda-YPDXDsaVC0) — стандартный метод, при котором пользователь сохраняет доступ до конца оплаченного периода.


---

## Описание

Этот endpoint позволяет немедленно отменить активную подписку пользователя в Stripe. Подписка прекращает действие сразу, без ожидания конца оплаченного периода.

### Откуда взять subscription_id

Во всех webhook-уведомлениях, связанных с подпиской, передаётся объект Subscription со своим ID. Этот ID:

* используется для идентификации подписки;
* необходим для её отмены через API.

⚠️ Обязательно сохраняйте `subscription_id` у себя — он потребуется для управления подпиской.

## URL

```
DELETE https://n8n.thenextgen.store/webhook/cancel_subscription
```

## Параметры запроса

### Заголовки

* **X-Partner-Api-Key** — ваш ключ EasyPay. Обязателен с 1 ноября 2026; подключить рекомендуем заранее. Ключ лежит в личном кабинете: раздел **API key and MCP Setup** → кнопка **Show key**.

### Query параметры (обязательные)

* **subscription_id** — ID подписки в Stripe, полученный через webhook (например: `sub_1SlxDHLoVAqE08foQiRVDkfy`)

## Пример запроса

```http
DELETE /webhook/cancel_subscription?subscription_id=sub_1SlxDHLoVAqE08foQiRVDkfy
X-Partner-Api-Key: <ваш ключ>
```

## Пример через Postman

* **HTTP Method:** `DELETE`
* **URL:** `https://n8n.thenextgen.store/webhook/cancel_subscription`
* **Query Param:** `subscription_id = sub_XXXXXXXXXXXX`
* **Header:** `X-Partner-Api-Key = <ваш ключ>`

## Логика работы

* Если подписка **активна** — она будет отменена в Stripe немедленно.
* Если подписка **уже отменена** — API вернёт ошибку (ожидаемое поведение).
* После отмены подписки Stripe обновляет её статус, а вы получаете webhook с обновлёнными данными.

## Ошибки

| Код | Что значит | Что делать |
|-----|------------|------------|
| `400` | `subscription_id` отсутствует или не похож на `sub_…` | проверьте параметр запроса |
| `401` | ключ не распознан или не передан | сверьте `X-Partner-Api-Key`, ключ копируется целиком |
| `403` | подписка принадлежит другому аккаунту | проверьте `subscription_id`; если уверены, что подписка ваша — напишите команде заботы |
| `409` | подписку мы ещё не видим у себя | так бывает в первые секунды после её создания — повторите через минуту |

## Важные замечания

* ✅ Подписка должна существовать и быть активной
* ✅ `subscription_id` должен быть валидным ID из Stripe
* ✅ Изменения применяются немедленно
* ⚠️ Доступ пользователя прекращается сразу, даже если оплаченный период ещё не закончился
* ⚠️ Повторный запрос на уже отменённую подписку вернёт ошибку — это ожидаемое поведение
* ⚠️ Этот метод **отменяет подписку немедленно** — для отмены в конце периода используйте [другой endpoint](https://docs.thenextgen.store/s/1fa79577-e778-443b-a4e4-187f47b93798/doc/endpoint-otmena-podpiski-v-konce-perioda-YPDXDsaVC0)


---

Вопросы по интеграции — пишите команде заботы EasyPay.