Главная ошибка — считать, что статус магазина и статус биллинга это одно и то же. У магазина есть свой жизненный цикл: active, grace, paused, canceled, refunded. У вас — право на доступ, дата следующего списания, попытки dunning, источник истины и локальный кэш. Если смешать эти уровни, появятся фантомные активы и преждевременные блокировки.
Правильная схема: хранить у себя каноническое состояние entitlement, а события из магазинов обрабатывать как входящие факты, а не команды. • Один webhook или receipt refresh не должен менять доступ напрямую без проверки перехода состояния • Любое обновление должно быть идемпотентным по transaction_id / purchase_token • Повторы и out-of-order события нужно принимать как норму, а не как ошибку инфраструктуры
Особый риск — восстановление после сетевого сплита или временной недоступности магазина. Если вы не строите reconciliation job, расхождения накапливаются: пользователь оплатил, магазин отдал подтверждение позже, а локальная система уже закрыла доступ. Нужны периодические сверки по активным подпискам, дедупликация событий и отдельный контур для спорных кейсов: grace, refund, chargeback, restore.
Идемпотентность в биллинге — это не рекомендация, а базовый вопрос выживания системы. Держите магазин как внешний источник фактов, а доступ — как собственное решение, принятое на основе набора проверок; иначе синхронизация станет генератором revenue leakage.
Подписки: биллинг-лаб
@subscriptions_billing_lab_arb
Синхронизация подписок с App Store и Google Play ломается не в API, а в модели состояний
Этот пост опубликован в Telegram-канале Подписки: биллинг-лаб (@subscriptions_billing_lab_arb). Все его публикации — на странице канала.
Открыть в Telegram