Skip to Content
СправочникСобытия вебхуков

События исходящих вебхуков

Ниже перечислены типы из ListeningEventList в коде API (строка, которую получает ваш обработчик в поле события / payload).

Подписка

  • subscription.created
  • subscription.activated
  • subscription.updated
  • subscription.auto_renew.success
  • subscription.auto_renew.failure
  • subscription.cancelled
  • subscription.end.of.this.cycle
  • subscription.resume.end.of.this.cycle
  • subscription.track — напоминание (~за 3 дня до конца периода)
  • subscription.track.willcancel
  • subscription.track.user.outofsubscribe
  • subscription.latest_invoice.track — напоминание по неоплаченному счёту
  • subscription.expired
  • subscription.failed

Отложенное изменение подписки (pending update)

  • subscription.pending_update.create
  • subscription.pending_update.success
  • subscription.pending_update.cancelled

Разовые аддоны подписки

  • subscription.onetime_addon.created
  • subscription.onetime_addon.success
  • subscription.onetime_addon.cancelled
  • subscription.onetime_addon.expired

Пользователь и метрики

  • user.created
  • user.updated
  • user.metric.update

Платежи и возвраты

  • payment.created
  • payment.authorised.need
  • payment.success
  • payment.cancelled
  • payment.failure
  • refund.created
  • refund.success
  • refund.failure
  • refund.cancelled
  • refund.reversed

Счета

  • invoice.created
  • invoice.paid
  • invoice.process
  • invoice.cancelled
  • invoice.failed
  • invoice.reversed

При настройке endpoint выберите подмножество событий, достаточное для вашей бизнес-логики, чтобы снизить нагрузку на ваш сервер.

Рекомендуемые действия интегратора

СобытиеРекомендуемое действие
subscription.activatedВключить доступ к продукту; сбросить кэш квот
subscription.updatedОбновить planId/лимиты у себя; сбросить кэш квот
subscription.cancelledОтключить доступ; сбросить кэш
subscription.expiredОтключить доступ по окончании периода
invoice.paidПодтвердить оплату; обновить статус подписки
invoice.failedУведомить пользователя; dunning
payment.successПодтвердить платёж (часто в паре с invoice.paid)
subscription.pending_update.successПрименить смену плана после оплаты апгрейда
user.metric.updateОбновить отображение usage/лимитов (опционально)

Для инвалидации кэша квот обычно достаточно: subscription.activated, subscription.updated, subscription.cancelled, invoice.paid.

Апгрейд подписки (платёж)

Типичный порядок при self-serve апгрейде free → paid через update_submit с редиректом:

  1. Пользователь возвращается на returnUrl — обновите подписку через API.
  2. Вебхуки могут прийти до или после return — проектируйте идемпотентную обработку.
  3. planId в подписке обновляется после успешной оплаты pending update (события выше).
СтатусыОшибки API и dunning