Если биллинг хранит только «активна/неактивна», он теряет важные переходы: trial, grace, hold, paused, pending renewal, revoked. Магазин может считать подписку действующей, пока ваш сервис уже отключил доступ, или наоборот — пользователь заплатил, а entitlement не поднялся из-за потери события. Идемпотентность в биллинге — это не рекомендация, а базовый вопрос выживания системы.
Правильная схема строится вокруг канонического состояния у вас в системе и асинхронной сверки с внешним источником. События от магазинов нужно принимать как «факты», а не как команду немедленно менять доступ. Для каждого receipt / token храните:
— последнее подтвержденное состояние;
— timestamp последней успешной валидации;
— источник истины для спорных переходов;
— журнал переходов с дедупликацией по event_id.
Дальше включается reconciliation loop: вебхуки ловят быстрые изменения, а фоновые джобы добирают пропущенные события, пересчитывают срок действия, статус оплаты и право на сервис. Если есть расхождение, приоритет у состояния, подтвержденного последней валидной проверкой у магазина, но с учетом grace-period и политики доступа. Это снижает revenue leakage и убирает случайные блокировки живых подписок ⚙️
Критический сценарий — повторная доставка, задержка webhook’ов и split-brain между кэшем, CRM и entitlement-service. Здесь помогают транзакционный outbox, версионирование состояния и строгое правило: одно событие — один переход, один переход — одна запись. Если этого нет, вы неизбежно получите фантомные отмены, двойные активации и спорные чарджи.
Синхронизация подписок — это не интеграция с API магазина, а дисциплина консистентности: фиксируйте источник истины, пересчитывайте состояние асинхронно и проектируйте систему так, будто каждое событие придет дважды.
Подписки: биллинг-лаб
@subscriptions_billing_lab_arb
Синхронизация подписок с App Store и Google Play ломается там, где нет единого state machine
Этот пост опубликован в Telegram-канале Подписки: биллинг-лаб (@subscriptions_billing_lab_arb). Все его публикации — на странице канала.
Открыть в Telegram