Ваше приложение может показать лист запроса возврата прямо внутри, и вот что Apple делает после того, как клиент нажимает «Отправить»

Apple позволяет клиенту запросить возврат, ни разу не выходя из вашего приложения. Один вызов StoreKit, beginRefundRequest, показывает собственный лист возврата Apple прямо внутри вашего интерфейса, клиент выбирает причину, и запрос уходит в Apple на рассмотрение. Вы не создаёте форму, вы не касаетесь денег и вы не решаете исход. Что вы получаете, это способ разместить путь к возврату там, где расстроенный клиент уже находится, вместо того чтобы потерять его в пользу его банка. Это встроенный запрос возврата, и его стоит понять, прежде чем решать, выпускать ли кнопку.

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

Что на самом деле представляет собой лист встроенного запроса возврата

beginRefundRequest, это метод StoreKit 2, который показывает лист запроса возврата для транзакции в оконной сцене. Сигнатура короткая: func beginRefundRequest(in scene: UIWindowScene) async throws -> Transaction.RefundRequestStatus. Когда вы вызываете его, система показывает лист с деталями покупки клиента и списком кодов причин на выбор. Этот интерфейс создаёт и контролирует Apple. Вы передаёте сцену и транзакцию, больше ничего.

Рекомендация Apple о том, куда её поместить, дана прямо. Вызывайте эту функцию из настроек аккаунта или меню помощи, чтобы клиент, желающий возврата, нашёл её там, где стал бы искать поддержку. Она вышла в iOS 15 и iPadOS 15, Mac Catalyst 15 и visionOS 1, так что любое приложение, нацеленное на эти версии, может показать её уже сегодня.

Два способа открыть лист

Есть две точки входа. Вы можете вызвать beginRefundRequest(in:) для конкретной транзакции, которая уже у вас есть, что ограничивает лист этой одной покупкой. Вы также можете открыть лист по идентификатору продукта, когда хотите, чтобы клиент вернул покупку конкретного продукта. В любом случае лист, список причин и решение принадлежат Apple. Ваша работа заканчивается на показе листа и чтении результата.

Что возвращает вызов и что может пойти не так

Метод помечен async throws, так что он либо возвращает статус, либо бросает ошибку. Оба списка короткие, и оба стоит обработать, чтобы ваш интерфейс говорил правду после закрытия листа.

Что происходит на вашем сервере после того, как клиент нажимает «Отправить»

Закрытие листа, это начало процесса, а не конец. Apple рассматривает запрос и берёт до 48 часов на одобрение или отказ. Для расходуемой встроенной покупки, прежде чем решить, App Store отправляет уведомление CONSUMPTION_REQUEST на ваш сервер, запрашивая данные об использовании. Если клиент согласился делиться этими данными, вы отвечаете через эндпоинт Send Consumption Information. Если он не согласился, собственная инструкция Apple, это вообще не отвечать на уведомление.

Как только Apple выносит решение, исход приходит на ваш сервер как App Store Server Notification. Это тот же поток, который вы уже получаете, и встроенный запрос попадает в него ровно так же, как возврат, который клиент начинает на странице reportaproblem от Apple. В обработке ничего не меняется только оттого, что запрос начался внутри вашего приложения.

Во что вам обходится эта кнопка и что она может сберечь

Возврат, который вы можете оспорить, лучше chargeback, который вы оспорить не можете

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

Вы снижаете трение на пути к возврату

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

Цена, которая идёт всё это время, это обслуживание возвращённого аккаунта

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

Стоит ли выпускать встроенный запрос возврата

Поместите её туда, где живёт поддержка, а не туда, где живут продажи

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

Проверьте весь путь в песочнице, прежде чем ему доверять

Вы можете смоделировать весь путь в песочнице и в тестировании StoreKit в Xcode, переводя запрос из «в ожидании» в «одобрено» или «отклонено». Одобрение доставляет уведомление REFUND на ваш сервер, а отказ доставляет REFUND_DECLINED, так что вы можете доказать, что ваш обработчик реагирует правильно, ещё до того, как реальный клиент нажмёт «Отправить».

Обрабатывайте каждый результат и никогда не преувеличивайте

Показывайте «в ожидании» при success, предлагайте повтор при failed, говорите, что ничего не изменилось, при userCancelled и относитесь к duplicateRequest как к тихой заметке о том, что прежний запрос клиента ещё в силе. Единственная ошибка, которая вредит, это сказать клиенту, что его возврат завершён, когда всё, что у вас есть, это отправленный запрос.

Как RefundHalt разбирается с последствиями

Встроенный лист принадлежит Apple. То, что идёт после него, принадлежит вам, и это та часть, которую ведёт RefundHalt. Когда клиент отправляет возврат изнутри вашего приложения, RefundHalt перехватывает CONSUMPTION_REQUEST для расходуемых покупок и отвечает на него в окне 12 часов теми доказательствами использования, которые помогают Apple решить. Когда Apple выносит решение, он отзывает право доступа по REFUND и оставляет доступ нетронутым по REFUND_DECLINED, каждое привязано к конкретной транзакции. Вы получаете возможность предложить более дружелюбный встроенный путь к возврату, не оставляя разбор, доказательства и отзыв на ручную суету.