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

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

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

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

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

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

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

  • Пользователь запрашивает полный возврат средств

  • Необходимо немедленно заблокировать доступ (нарушение правил, мошенничество)

  • Пользователь хочет отменить подписку сразу после случайной оплаты

  • Требуется prorate refund (возврат за неиспользованное время)

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

Для сравнения: Отмена подписки в конце периода — стандартный метод, при котором пользователь сохраняет доступ до конца оплаченного периода.

Описание

Этот 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)

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

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

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