Користувач не помітив збій списання — через день він заблокований, 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
| Параметр | iOS (StoreKit 2) | Android (Google Play Billing) |
|---|---|---|
| Тривалість grace period | 3, 6 або 16 днів (налаштовується) | 1–7 днів (залежить від ціни та регіону) |
| Статус клієнта | inGracePeriod |
SUBSCRIPTION_IN_GRACE_PERIOD |
| Статус після закінчення | inBillingRetryPeriod (до 60 днів) |
SUBSCRIPTION_EXPIRED (одразу) |
| Клієнтська перевірка | Product.SubscriptionInfo.Status |
Purchase.purchaseState + isAutoRenewing |
| Серверні сповіщення | App Store Server Notifications V2 | RTDN (Pub/Sub) |
Серверна валідація: чому це важливо?
Клієнтська перевірка через StoreKit зручна для UI, але не повинна бути єдиним джерелом істини. Користувач міг відкрити додаток через кілька днів — кеш StoreKit міг не оновитися. Сервер отримує надійні сповіщення та зберігає актуальний статус.
Схема роботи з App Store Server Notifications V2
- Apple надсилає POST-запит на ваш endpoint з типом
DID_FAIL_TO_RENEWта причиноюIN_GRACE_PERIOD. - Сервер валідує підпис і оновлює поле
subscription_statusу базі наgrace_period. - Мобільний клієнт при запуску запитує
/me/subscriptionта отримує актуальний статус. - Якщо grace period закінчився — Apple надсилає
GRACE_PERIOD_EXPIRED, сервер змінює статус наexpiredі блокує доступ при наступному запиті.
Те саме для Android з RTDN: SUBSCRIPTION_IN_GRACE_PERIOD та SUBSCRIPTION_EXPIRED.
Типові помилки реалізації
- Блокування контенту одразу після збою списання (ігнорування grace period).
- Неперевірка статусу
inBillingRetry— контент або відкрито, або закрито неправильно. - Відсутність серверної валідації — користувач може отримати доступ без підписки.
- Занадто агресивний paywall у grace period (порушення гайдлайнів).
Процес роботи над проектом
- Аудит поточної підписної логіки та консолей розробника.
- Увімкнення grace period в App Store Connect та Google Play Console.
- Реалізація клієнтської обробки статусів (Swift/Kotlin) та UI-банерів.
- Інтеграція серверних сповіщень (App Store Server Notifications V2 / RTDN).
- Тестування сценаріїв: збій списання, вхід у grace period, вихід із grace period.
- Навантажувальне тестування та моніторинг.
Що входить у роботу?
- Детальний аудит поточної підписної системи.
- Налаштування 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+ років досвіду в мобільних підписках.
FAQ: Grace period
Що таке grace period у контексті мобільних підписок? Grace period — це пільговий період після невдалого списання, коли підписка вважається активною. Він дає користувачеві час на оновлення платіжних даних без втрати доступу.
Як довго триває grace period на iOS? На iOS тривалість grace period налаштовується в App Store Connect: 3, 6 або 16 днів.
Чи потрібно блокувати контент під час grace period? Ні, контент має залишатися доступним. Достатньо показати м'яке попередження із закликом оновити платіжні дані.
Чим відрізняється grace period від billing retry на iOS? Grace period — перший етап, контент доступний. Після його завершення настає billing retry (до 60 днів), коли контент блокується, але Apple продовжує спроби списання.
Як забезпечити надійну серверну обробку grace period? Використовуйте App Store Server Notifications V2 (iOS) та RTDN (Android) для отримання подій на бекенді та оновлення статусу підписки в реальному часі.