Обработка возвратов ломается незаметно, поэтому протестируйте возвраты за встроенные покупки в sandbox раньше, чем это сделает реальный клиент

Ваша обработка возвратов это единственный путь кода, который запускается только после того, как клиент уже ушёл. Ничто в вашем обычном QA его не затрагивает, потому что чтобы до него добраться, вам нужно реально получить возврат. Поэтому он выходит непротестированным, тихо лежит месяцами, а затем даёт сбой на реальном возврате, где сбой стоит денег, а не красного теста. Решение в том, чтобы перестать считать возврат чем-то, что происходит с вами, и начать запускать его намеренно. И Apple, и Google позволяют запустить возврат в тестовой среде и посмотреть, как реагирует ваш сервер. Вот как протестировать возвраты за встроенные покупки в App Store и Google Play до того, как платящий клиент докажет, что ваш обработчик был сломан.

Три среды, в которых может сработать возврат, и только одна из них продакшн

Есть три отдельных места, где можно запустить возврат Apple или Google, пока вы разрабатываете, и они не взаимозаменяемы. Два из них вы можете запускать по требованию. Третье это продакшн, где вы никогда не хотите впервые встретить ошибку возврата. Ловушка в том, чтобы считать, что лёгкий вариант, локальное тестирование в Xcode, доказывает работу всего конвейера. Он доказывает работу вашего приложения. Он ничего не говорит о вашем сервере.

Тестирование StoreKit в Xcode локально, поэтому оно проверяет ваше приложение и ничего больше

Встроенное тестирование StoreKit в Xcode работает с конфигурационным файлом на вашем Mac, без обращения к Apple. Откройте StoreKit Transaction Manager из панели отладки, выберите оплаченную транзакцию и нажмите изогнутую стрелку возврата. Транзакция переключается на возвращённую, и слушатель Transaction.updates вашего приложения срабатывает точно так же, как это было бы в реальности. Вы также можете вызвать beginRefundRequest, чтобы показать настоящий лист возврата, и в среде Xcode выбранная вами проблема сопоставляется один к одному с RevocationReason, а возврат применяется немедленно. Это самый быстрый способ доказать, что ваш клиент отрезает доступ в тот момент, когда revocationDate становится не-nil. Это же и всё, что может сказать локальное тестирование, потому что здесь ничто никогда не достигает серверов Apple, поэтому App Store Server Notification не отправляется. Ваш бэкенд не узнаёт ничего.

Sandbox это место, где ваш сервер наконец узнаёт о возврате

Чтобы протестировать ту половину вашей интеграции, которая решает про деньги, ваш сервер, вам нужен sandbox Apple. Настройте sandbox-URL App Store Server Notifications V2 в App Store Connect, войдите под sandbox-тестировщиком на устройстве и совершите покупку. Теперь возврат в sandbox доставляет настоящее уведомление REFUND на ваш бэкенд, а запрос на возврат по расходуемой или автообновляемой покупке доставляет CONSUMPTION_REQUEST, тот же подписанный payload, который получит ваш продакшн-сервер. Прежде чем что-либо запускать, вызовите эндпоинт Request a Test Notification. Он говорит серверу App Store отправить уведомление типа TEST на настроенный вами URL и выдаёт вам testNotificationToken, который вы передаёте в Get Test Notification Status, чтобы подтвердить доставку. Если этот цикл не работает, реальное уведомление тоже не сработает.

Как протестировать возвраты за встроенные покупки в App Store

Выполняйте в таком порядке, от дешёвой проверки клиента до полного серверного цикла. Каждый шаг проверяет свою часть, и именно за поздние шаги продакшн реально выставляет вам счёт.

• Создайте ключ In-App Purchase в разделе Users and Access, Integrations, In-App Purchase в App Store Connect и используйте его для подписи ваших вызовов App Store Server API.
• Направьте ваш sandbox-URL App Store Server Notifications V2 на ваш бэкенд, затем вызовите Request a Test Notification и убедитесь, что payload TEST приходит и проверяется по цепочке сертификатов Apple.
• В Transaction Manager Xcode верните покупку и убедитесь, что ваше приложение снимает право доступа в тот момент, когда установлен revocationDate.
• Войдите под sandbox-тестировщиком, купите расходуемый товар, запросите возврат и убедитесь, что ваш сервер получает CONSUMPTION_REQUEST и может собрать и отправить ответ Send Consumption Information с хорошим запасом внутри 12-часового окна.
• Верните покупку в sandbox и убедитесь, что уведомление REFUND достигает вашего сервера, что вы отзываете доступ или списываете баланс расходуемого товара и что повторная доставка того же уведомления не применяется дважды.

Как отрепетировать возврат и чарджбэк в Google Play

У Google Play нет локального режима, как у Xcode. Всё работает с серверами Google, но лицензионные тестировщики делают это бесплатно и безопасно. Добавьте ваши тестовые аккаунты Google как лицензионных тестировщиков в Play Console, и они получат набор тестовых способов оплаты, которые никогда не списывают реальные деньги. Google помечает каждую тестовую покупку уведомлением посреди диалога покупки, и налоги не рассчитываются. Для тестирования возвратов важно, какой тестовый инструмент вы выберете, потому что каждый из них ведёт к своему исходу.

Запустите возврат, чарджбэк и автовозврат по подтверждению

• Купите с помощью тестовой карты approve-then-charge-back, и PendingRefundReviewNotification придёт в вашу тему Real-time Developer Notifications мгновениями позже. Ответьте на него одним вызовом orders.reviewrefund, потому что Google хранит только ваш первый ответ.
• Верните и отзовите тестовый заказ во вкладке Orders в Play Console, чтобы запустить VoidedPurchaseNotification, и убедитесь, что ваш сервер снимает право доступа.
• Намеренно оставьте покупку лицензионного тестировщика неподтверждённой. Google автоматически возвращает её через 3 минуты вместо 3 дней, которые допускает продакшн, и присылает вам письмо об отмене, так что сломанный путь подтверждения проявляется за минуты, а не на четвёртый день в продакшене.

Во что на самом деле обходится непротестированный путь возврата

Обработчик возвратов это не украшение. Это код, который останавливает трату на обслуживание того, кто вам больше не платит. Когда он даёт сбой тихо, возврат всё равно проходит, но доступ, баланс и траты за ними не прекращаются.

Проследите за деньгами. Когда Apple или Google возвращает покупку, вы возвращаете цену продажи, а магазин возвращает свою комиссию, и пока что баланс ровный. Что не возвращается, так это всё, что вы уже потратили на доставку продукта: вычисления за сгенерированным результатом, вызовы model API, хранилище для того, что сохранил пользователь, выплата, которую вы уже отправили автору. Обработчик возвратов, который никогда не отзывает доступ, позволяет получившему возврат пользователю продолжать тратить это за ваш счёт, и в системе не остаётся ничего, что бы его отрезало.

Два окна доказательств делают это резче. CONSUMPTION_REQUEST, который вы никогда не отрабатывали в sandbox, это ответ, который вы отправите некорректным или с опозданием, и Apple часто предоставляет возврат по умолчанию, когда ваш ответ не приходит внутри 12 часов. Ответ на чарджбэк в Google Play, который вы никогда не запускали с тестовой картой, это 24-часовое окно, которое вы упускаете вживую, и с 3 августа 2026 года проигранный чарджбэк в Play стоит вам цены покупки за вычетом сервисного сбора Play плюс комиссия банка за чарджбэк. Каждый из этих сбоев воспроизводим бесплатно в тестовой среде сначала. Ни один из них не дёшев в продакшене.

Короткий чек-лист перед тем, как выпускать обработку возвратов

Вам не нужна лаборатория. Вам нужно один раз увидеть, как каждое событие доходит до вашего кода.

• Ваше приложение снимает доступ в тот момент, когда транзакция StoreKit показывает revocationDate, подтверждено в Transaction Manager Xcode.
• Ваш sandbox-URL сервера получает уведомление TEST и проверяет его по сертификатам Apple.
• Sandbox REFUND отзывает доступ или списывает баланс, а повторная доставка не считается дважды.
• Sandbox CONSUMPTION_REQUEST порождает валидный ответ Send Consumption Information с хорошим запасом внутри 12 часов.
• PendingRefundReviewNotification от Google с тестовой карты чарджбэка порождает ровно один вызов orders.reviewrefund.
• Неподтверждённая тестовая покупка в Google Play автоматически возвращается за 3 минуты, и ваша сверка это замечает.

Пройдите этот список один раз, и обработка возвратов перестанет быть кодом, который вы надеетесь работает. Она станет кодом, который вы видели работающим.