Retention Messaging API от Apple выводит ваши слова на экран отмены, но запросы на возврат через него никогда не проходят

Подписчикам, которые нажимают «Отменить» на iPhone, теперь можно до подтверждения показать выбранное вами сообщение, более дешевый тариф или скидку. Это Retention Messaging API от Apple, и впервые разработчик получает слово на собственном экране отмены Apple. Пока это предварительная версия, доступ к которой нужно запросить. И у нее есть жесткая граница, важная, если вам небезразличны возвраты: она обращается к людям, которые вот-вот перестанут платить, а не к тем, кто хочет вернуть деньги. Такие запросы попадают в Apple другим путем.

Что делает Retention Messaging API от Apple

Retention Messaging API работает по схеме «сервер к серверу». Вы заранее загружаете в Apple тексты сообщений и изображения, Apple их проверяет, а затем вы выбираете, какое одобренное сообщение увидит подписчик, собравшийся отменить автопродлеваемую подписку. Документация Apple называет четыре типа сообщений:

• Текстовое сообщение, в котором могут быть пункты списка.
• Текстовое сообщение с изображением.
• Сообщение о смене тарифа, которое предлагает другую подписку из той же группы подписок.
• Сообщение с промо-предложением, которое предлагает сниженную цену на том же или другом уровне с помощью промо-предложения, настроенного в App Store Connect и подписанного на вашем сервере.

Сообщение появляется после того, как клиент нажал Cancel Subscription (Отменить подписку) на странице с деталями подписки. Затем Apple показывает страницу Confirm Cancellation (Подтвердить отмену). Клиент по-прежнему может отменить подписку, нажать Keep Subscription (Сохранить подписку) или принять предложенные вами скидку или тариф. Спрятать выход нельзя, а Apple требует от разработчиков не загружать вводящий в заблуждение или неточный контент.

Сообщения по умолчанию и режим реального времени

Есть два способа работы. Простой: сообщения по умолчанию, то есть текст с изображением или пунктами либо без них, назначенный для каждого продукта и локали. Более гибкий: режим реального времени, в котором Apple вызывает эндпоинт Get Retention Message на вашем сервере, а вы отвечаете идентификатором сообщения. Только в режиме реального времени можно показывать сообщения о смене тарифа и с промо-предложениями.

На практике сообщения по умолчанию обязательны. Apple использует их как запасной вариант, когда вызов в реальном времени не удался, и вообще не показывает сообщение об удержании для продукта в любой локали, где нет сообщения по умолчанию.

Что Apple сообщает вашему серверу при вызове в реальном времени

Запрос представляет собой JWS, подписанный App Store. После декодирования в нем есть originalTransactionId, appAppleId, productId, userLocale, UUID requestIdentifier, среда и signedDate. Apple велит проверять, что appAppleId совпадает с вашим приложением, и не отвечать, если не совпадает. Самое полезное здесь originalTransactionId: по нему можно посмотреть, что этот подписчик на самом деле делал в вашем приложении, прежде чем решить, что ему сказать.

Где появляется сообщение об удержании, а где нет

Apple показывает сообщение на одном экране: на шаге Confirm Cancellation после нажатия Cancel Subscription, например в Apple Account > Subscriptions или на странице подписки в App Store. Этот экран решает, состоится ли следующее продление. Уже полученных денег он не касается.

Запрос на возврат это отдельное действие. Страница поддержки Apple отправляет клиентов на reportaproblem.apple.com, где они выбирают «Request a refund» (Запросить возврат), указывают причину и покупку и ждут ответа от 24 до 48 часов. Внутри вашего приложения beginRefundRequest из StoreKit открывает окно возврата Apple, и, по словам Apple, App Store нужно до 48 часов, чтобы одобрить или отклонить запрос. Ни один из этих путей не проходит через экран Confirm Cancellation.

Может ли сообщение об удержании остановить запрос на возврат?

Нет. Запрос на возврат никогда не доходит до экрана, где находится сообщение. Одна деталь в документации Apple по уведомлениям делает это наглядным. Когда клиент запрашивает возврат в вашем приложении через API запросов на возврат, Apple сам отключает автопродление и отправляет DID_CHANGE_RENEWAL_STATUS с подтипом AUTO_RENEW_DISABLED. Клиент, который отменяет подписку на странице настроек Subscriptions, порождает те же тип и подтип. Ваш сервер видит одно уведомление для двух совершенно разных клиентов, и только один из них видел ваше сообщение об удержании.

Если запрос на возврат идет дальше, канал для доказательств это CONSUMPTION_REQUEST. Apple присылает его при запросах на возврат по любому типу продукта, и у вас есть 12 часов, чтобы ответить через Send Consumption Information. Отвечать можно только при согласии клиента. После этого решение Apple приходит уведомлением REFUND или REFUND_DECLINED, если Apple отклоняет возврат, запрошенный клиентом в вашем приложении.

Есть ли у Google Play API для сообщений при отмене?

Не согласно документации Google о жизненном цикле подписок. Подписчик Google Play отменяет подписку в центре подписок Play, сохраняет доступ до конца текущего платежного периода и до тех пор может нажать Resubscribe (Подписаться снова), чтобы все вернуть. Google называет это восстановлением. Вы узнаете об отмене постфактум из уведомления SUBSCRIPTION_CANCELED, а поле userInitiatedCancellation в ресурсе подписки сообщает, почему пользователь ушел. Пауза, которая, по словам Google, включена по умолчанию для всех подписок, это главный встроенный способ сократить добровольный отток.

Со стороны возвратов у Google Play свой канал для доказательств. PendingRefundReviewNotification приходит, когда чарджбэк требует проверки разработчиком, и у вас есть 24 часа, чтобы ответить через orders.reviewrefund. По заказам, оформленным после 3 августа 2026 года, при удовлетворенном чарджбэке Google перекладывает на разработчика цену покупки за вычетом сервисного сбора Play, а также комиссии банка за чарджбэк.

Сколько денег стоит вам экран отмены

Retention messaging кажется бесплатным. Это не так, и счета приходят из трех мест.

Вычисления при каждом просмотре страницы

Apple вызывает ваш эндпоинт, когда активный подписчик открывает страницу с деталями подписки и кнопкой «Отменить», а не только когда он отменяет. Каждый визит это запрос, который ваш сервер должен аутентифицировать, обработать и ответить на него за 700 мс, иначе Apple покажет сообщение по умолчанию. Это исключает функцию с холодным стартом, которой иногда нужно две секунды. Вы платите за постоянно прогретые мощности плюс за все чтения из базы данных и платные вызовы сторонних API, которые ваша логика принятия решений делает на каждый запрос.

Скидка это выручка, от которой вы отказались сами

Промо-предложение, которое удержало подписчика, это реально сохраненные деньги. Предложение тому, кто и так остался бы, это чистая скидка. Вот иллюстрация, а не эталонный показатель. Месячный тариф за 9,99 $ с предложением половинной цены на три месяца теряет 14,99 $ на каждом принятом предложении. Если каждый третий из принявших остался бы и по полной цене, тысяча принятий обходится примерно в 5 000 $ скидки людям, которым она была не нужна. По другую сторону баланса стоят подписчики, которые действительно уходили.

Возврат, который провоцирует неприятный выход

Apple оставляет кнопку Cancel Subscription на странице, так что удержать человека в ловушке нельзя, но раздражать все еще можно. У клиента, на которого давят, есть другой вариант: попросить Apple вернуть последний платеж. Когда возврат происходит, деньги уходят обратно, а вычисления, хранение, вызовы API и любые партнерские выплаты, связанные с этим подписчиком, остаются потраченными. Эти расходы не вернет ни одно сообщение об удержании.

Как пользоваться retention messaging, не повышая долю возвратов

Относитесь к экрану отмены как к месту для точности, а не для хитрости. Несколько правил удерживают его на правильной стороне границы возвратов:

• Решайте для каждого подписчика отдельно. По originalTransactionId из запроса Apple посмотрите недавнее использование. Скидку или более дешевый тариф предлагайте тем, кто пользуется продуктом. Тем, кто не открывал его неделями, покажите короткое честное сообщение.
• Отвечайте быстро. Рассчитывайте решение заранее, когда меняются данные об использовании, чтобы сам запрос был одним поиском, который с запасом укладывается в 700 мс.
• Напишите сообщение по умолчанию для каждого продукта и локали. Без него неудачный вызов означает, что сообщения не будет вовсе.
• Внимательно следите за AUTO_RENEW_DISABLED. Если следом приходит CONSUMPTION_REQUEST для того же originalTransactionId, перед вами запрос на возврат, а не отмена, и 12-часовой отсчет уже пошел.
• Отвечайте на каждый CONSUMPTION_REQUEST, на который вам разрешено ответить. RefundHalt отправляет Apple точные данные о потреблении в 12-часовом окне и отвечает на проверку чарджбэка в Google Play в течение 24 часов, потому что это единственные два момента, когда магазины спрашивают вашу позицию.

Стоит ли просить у Apple доступ?

Если вы продаете автопродлеваемые подписки и уже обрабатываете App Store Server Notifications V2, скорее всего, да. Экран отмены это последнее место, где можно достучаться до подписчика перед уходом, а смена тарифа обходится дешевле, чем потеря его целиком. Просто заложите бюджет на эндпоинт, который отвечает при каждом просмотре страницы подписки, и держите защиту от возвратов там, где возвраты действительно происходят.