Реалізація Grace Period при невдалому списанні підписки

Користувач не помітив збій списання — через день він заблокований, retention падає на 30% при першій же відмові. Grace period дає 3–16 днів на виправлення без втрати доступу. Ми реалізуємо механізм пільгового періоду під ключ: від увімкнення в консолях до серверної валідації, щоб ваш додаток відповідав гайдлайнам App Store та Google Play.

Як grace period впливає на виручку?

Без grace period кожен збій списання обертається втратою підписника. Навіть якщо він повернеться, негативний досвід знижує LTV. За даними звіту RevenueCat, правильний grace period збільшує retention на 15–20%, що при середньому чеку $10/міс дає $1.5–2 додаткової виручки з користувача на місяць. Це прямий вплив на bottom line без зміни ціни. Для порівняння: використання grace period у 2 рази ефективніше за стандартні методи вирішення платіжних проблем.

Що таке grace period і як його ввімкнути?

Grace period — етап після невдалого списання, коли підписка залишається активною, а Apple або Google продовжують спроби списання (dunning process). Користувач бачить контент, але отримує м'яке попередження. Вмикається в консолях розробника.

iOS: налаштування в App Store Connect

Перейдіть в App Store Connect → Subscriptions → виберіть групу → Grace Period. Доступні варіанти: 3, 6 або 16 днів. Після активації Apple автоматично надсилає статус inGracePeriod у StoreKit. Обробляємо його на клієнті:

import StoreKit func checkSubscriptionStatus(productId: String) async -> SubscriptionAccessLevel { guard let product = try? await Product.products(for: [productId]).first, let statuses = try? await product.subscription?.status else { return .notSubscribed } for status in statuses { switch status.state { case .subscribed: return .active case .inGracePeriod: // Списання не пройшло, але grace period активний // Показуємо м'яке попередження, не блокуємо контент return .gracePeriod case .inBillingRetryPeriod: // Grace period закінчився, Apple продовжує спроби списання (до 60 днів) // Контент НЕ доступний return .billingRetry case .expired, .revoked: return .notSubscribed default: continue } } return .notSubscribed } enum SubscriptionAccessLevel { case active, gracePeriod, billingRetry, notSubscribed } 

App Store Server Notifications V2 дублюють подію DID_FAIL_TO_RENEW з причиною IN_GRACE_PERIOD. Сервер має обробляти обидва канали для надійності.

Android: налаштування в Google Play Console

У Google Play Console виберіть продукт → Підписка → Пільговий період. Тривалість залежить від ціни та регіону: зазвичай 1–7 днів. Google надсилає RTDN-повідомлення SUBSCRIPTION_IN_GRACE_PERIOD:

fun handleSubscriptionNotification(notification: SubscriptionNotification) { when (notification.notificationType) { SubscriptionNotification.SUBSCRIPTION_IN_GRACE_PERIOD -> { showGracePeriodWarning() } SubscriptionNotification.SUBSCRIPTION_EXPIRED -> { revokeAccess() } } } 

Сервер отримує повідомлення через Pub/Sub і оновлює статус у базі. Клієнт може перевіряти через Purchase.purchaseState та isAutoRenewing, але покладатися тільки на клієнт не варто.

Що показувати користувачеві в grace period

Ключовий принцип: контент не блокувати, але м'яко попередити. Агресивний paywall у grace period — поганий UX та порушення Section 4.2 гайдлайнів App Store.

// SwiftUI-банер if subscriptionStatus == .gracePeriod { GracePeriodWarningBanner( message: "Не вдалося списати оплату. Оновіть дані картки, щоб зберегти доступ.", actionTitle: "Управління підпискою", action: { openManageSubscriptions() } ) } func openManageSubscriptions() { Task { try? await AppStore.showManageSubscriptions(in: windowScene) } } 

На Android — аналогічний банер із кнопкою переходу в Google Play для зміни способу оплати.

Порівняння grace period на iOS та Android

Серверна валідація: чому це важливо?

Клієнтська перевірка через StoreKit зручна для UI, але не повинна бути єдиним джерелом істини. Користувач міг відкрити додаток через кілька днів — кеш StoreKit міг не оновитися. Сервер отримує надійні сповіщення та зберігає актуальний статус.

Схема роботи з App Store Server Notifications V2

1. Apple надсилає POST-запит на ваш endpoint з типом DID_FAIL_TO_RENEW та причиною IN_GRACE_PERIOD.
2. Сервер валідує підпис і оновлює поле subscription_status у базі на grace_period.
3. Мобільний клієнт при запуску запитує /me/subscription та отримує актуальний статус.
4. Якщо grace period закінчився — Apple надсилає GRACE_PERIOD_EXPIRED, сервер змінює статус на expired і блокує доступ при наступному запиті.

Те саме для Android з RTDN: SUBSCRIPTION_IN_GRACE_PERIOD та SUBSCRIPTION_EXPIRED.

Типові помилки реалізації

• Блокування контенту одразу після збою списання (ігнорування grace period).
• Неперевірка статусу inBillingRetry — контент або відкрито, або закрито неправильно.
• Відсутність серверної валідації — користувач може отримати доступ без підписки.
• Занадто агресивний paywall у grace period (порушення гайдлайнів).

Процес роботи над проектом

1. Аудит поточної підписної логіки та консолей розробника.
2. Увімкнення grace period в App Store Connect та Google Play Console.
3. Реалізація клієнтської обробки статусів (Swift/Kotlin) та UI-банерів.
4. Інтеграція серверних сповіщень (App Store Server Notifications V2 / RTDN).
5. Тестування сценаріїв: збій списання, вхід у grace period, вихід із grace period.
6. Навантажувальне тестування та моніторинг.

Що входить у роботу?

• Детальний аудит поточної підписної системи.
• Налаштування grace period у консолях розробника.
• Код клієнтської та серверної частини (Swift/Kotlin, backend).
• Інтеграція серверних сповіщень (App Store Server Notifications V2, RTDN).
• Документація з описом архітектури та інструкції для розробників.
• Технічна підтримка протягом 1 місяця після впровадження.
• Гарантія на роботу механізму grace period у вашому додатку.

Терміни та вартість впровадження

Клієнтська частина з UI-логікою займає 2–3 дні (вартість від $500). Повний цикл із серверною обробкою сповіщень — 4–5 днів (від $1500). Наш досвід: 10+ років у мобільних підписках, 50+ успішних проектів, гарантія на технічну підтримку 3 місяці. Зв'яжіться з нами для оцінки вашого проекту та отримання консультації інженера з 10+ років досвіду в мобільних підписках.