1. payment.completed
Описание: Завершение одноразового платежа (лайфтайм)
Когда отправляется: При успешной оплате единоразового товара или услуги
2. subscription.created
Описание: Создание новой подписки
Когда отправляется: При первом создании подписки пользователе
3. subscription.updated
Описание: Обновление существующей подписки
Когда отправляется: При изменении статуса, плана или других параметров по
4. subscription.cancelled
Описание: Отмена подписки
Когда отправляется: При отмене подписки пользователем или системой
5. refund.create
Описание: Создание возврата средств
Когда отправляется: При оформлении возврата платежа
Последовательность событий
Сценарий 1: Покупка лайфтайм доступа (одноразовый платеж)
Пользователь оплачивает → payment.completed
Пример последовательности:
payment.completed
- платеж успешно завершен
В случае возврата:
Возврат средств → refund.created
refund.created
- возврат средств оформлен
Сценарий 2: Покупка подписки без пробного периода
Пользователь оплачивает → subscription.created
Пример последовательности:
subscription.created
- подписка создана и активирована
При продлении подписки:
subscription.updated
- подписка автоматически продлена
Для текущей подписки будут отправлены обновленные subscription.current_period_start и subscription.current_period_end
При отмене подписки:
Вариант A: Отмена в конце периода
Пользователь отменяет → [в конце периода] → subscription.cancelled
subscription.cancelled
- подписка отменена в конце периода
Подписка остаётся в статусе
active
до конца периода, после статус подписки изменится на cancelled
Вариант B: Немедленная отмена
Пользователь отменяет → subscription.cancelled
subscription.cancelled
- подписка немедленно отменена
Сценарий 3: Покупка подписки с пробным периодом
Пользователь начинает пробный период → subscription.created (статус: trialing) → [конец пробного периода] → subscription.updated (статус: active)
Пример последовательности:
subscription.created
- подписка создана в статусе "trialing"
Также будут переданы поля subscription.trial_period_start и subscription.trial_period_end
subscription.updated
- пробный период закончился, подписка стала активной
Для текущей подписки будут отправлены обновленные subscription.current_period_start и subscription.current_period_end
Если пользователь отменяет во время пробного периода:
Пользователь отменяет в триале → subscription.cancelled
- subscription.cancelled - подписка отменена во время пробного периода
Сценарий 4: Обновление подписки (смена плана)
Пользователь меняет план → subscription.updated
Пример последовательности:
subscription.updated
- план подписки изменен
Возможные изменения, приводящие к subscription.updated:
- Смена тарифного плана (апгрейд/даунгрейд)
- Продление подписки
- Реактивация отмененной подписки
Сценарий 5: Возврат средств по подписке
Возврат по активной подписке → refund.created → subscription.cancelled
Пример последовательности:
refund.created
- возврат средств оформлен
subscription.cancelled
- подписка отменена из-за возврата