Возврат через Advanced Commerce API остаётся единственным способом, которым iOS-разработчик может инициировать возврат, и окончательное решение всё равно за Apple

Обычные iOS-разработчики не могут вернуть деньги клиенту. В июне 2026 года App Store Commerce Engineer ответил на вопрос на форуме разработчиков одной фразой: в настоящее время разработчик не может напрямую оформить возврат. Есть одно исключение, и оно находится внутри Advanced Commerce API. Приложения, которые Apple к нему допускает, могут отправить запрос на возврат через Advanced Commerce API, отозвать подписку с возвратом денег или запросить произвольную сумму. Переводить ли деньги, по-прежнему решает Apple.

Что такое Advanced Commerce API и кто его получает

Apple выпустила Advanced Commerce API 23 января 2025 года. Он обрабатывает встроенные покупки Apple для исключительно больших каталогов: произвольных разовых покупок, подписок и подписок с дополнительными опциями. Вы не создаёте каждый продукт в App Store Connect. Вы определяете SKU на своём сервере и передаёте их Apple в момент покупки.

Доступ выдаётся отдельно для каждого приложения. Вы заполняете форму заявки, а страница Apple о соответствии требованиям называет три бизнес-модели, которые должны быть основой приложения:

• Исключительно большие каталоги разовых покупок, например аудиокниги, занятия, курсы или мини-приложения.
• Исключительно большие каталоги контента по подписке, где предложение каждого автора является отдельной подпиской.
• Подписка с дополнительными опциями, которые продлеваются вместе как одна покупка, например премиальные каналы или спорт.

Apple также разрешает подать заявку, если API требуется для другой программы. Его требует Mini Apps Partner Program, которая выплачивает участникам 85% от соответствующих продаж встроенных покупок в размещённых мини-приложениях.

Endpoints для возвратов появились позже, и для них нужна подпись

Версия 1.1 от 24 марта 2025 года добавила Request Transaction Refund и Revoke Subscription. Страница программы Apple говорит, что приложения с контентом по подписке также могут получить право на API Cancel, Revoke и Refund, чтобы обрабатывать отмены, проверять контент после покупки и управлять каталогами. Страница каждого endpoint добавляет одно и то же условие: ваш Account Holder должен подписать Advanced Commerce API Addendum, а если последняя версия не принята, вызов вернёт ошибку. Сценарии использования каждого endpoint перечислены в Addendum, а не в документации.

Три endpoint рядом

Cancel a Subscription останавливает следующее списание

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

Revoke Subscription прекращает всё сразу

Revoke устанавливает автопродление в false и отзывает подписку с полным или пропорциональным возвратом. Тело запроса содержит refundReason, refundRiskingPreference, refundType и requestInfo. Затем Apple отправляет уведомление REFUND на ваш endpoint App Store Server Notifications V2. Указание Apple конкретное: отключайте доступ с даты revocationDate из этого уведомления и не отключайте его до того, как уведомление придёт.

Request Transaction Refund работает по позициям

Это точный инструмент. Вы отправляете список позиций, и в каждой указаны SKU, refundReason, refundType и флаг revoke. С CUSTOM вы также передаёте refundAmount в тысячных долях денежной единицы, то есть 4990 означает 4,99. Если отправить сумму с FULL или PRORATED, Apple отклонит запрос с ошибкой 4000155. Ответ содержит подписанную транзакцию, а для подписок ещё и подписанные данные о продлении.

Apple принимает такие значения refundReason: UNINTENDED_PURCHASE, FULFILLMENT_ISSUE, UNSATISFIED_WITH_PURCHASE, LEGAL, OTHER и MODIFY_ITEMS_REFUND. Седьмое значение, SIMULATE_REFUND_DECLINE, предназначено только для тестирования в sandbox и TestFlight. Оно существует потому, что App Store может отказать.

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

Название endpoint честное. Это запрос. Два поля показывают, где на самом деле принимается решение.

refundRiskingPreference открывает дорогу проверке потребления

Apple описывает refundRiskingPreference как признак того, запросит ли App Store у вас данные о потреблении для решения о возврате. По умолчанию значение true. Если оно true, вы получаете CONSUMPTION_REQUEST по собственному запросу на возврат и отвечаете через Send Consumption Information. Apple просит разработчиков ответить в течение 12 часов после получения CONSUMPTION_REQUEST. Установите false, и это уведомление не придёт.

Ошибки, которые означают отказ

К PendingRefundError нужно готовиться заранее. Вероятная причина: клиент уже обратился к Apple через Report a Problem до того, как отреагировала ваша поддержка. Правила Apple и так требуют, чтобы у этих приложений был путь к возврату внутри приложения, ссылка Report a Problem или API beginRefundRequest, поэтому обе двери открыты одновременно.

Во сколько вам обходится возврат через Advanced Commerce API

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

Налог внутри произвольной суммы

По словам Apple, запрошенный refundAmount должен включать налог во всех регионах, кроме Канады и США. Команда, которая рассчитывает возврат CUSTOM от цены SKU без налога, недоплатит клиентам во всех остальных витринах, а потом потратит время поддержки на исправление каждого случая.

Расходы, которые не возвращаются

• Выплаты: в каталоге авторов или у хоста мини-приложений доля автора часто выплачивается при продаже. Возврат клиенту её не вернёт.
• Лицензии на контент: отчисления правообладателю за аудиокнигу или курс могут, в зависимости от договора, начисляться уже при доступе, и возврат их не отменяет.
• Вычисления: стриминг, транскодирование и вся серверная работа по покупке уже в вашем счёте.
• Вызовы API: сторонние сервисы с оплатой за запрос, от распознавания речи до инференса моделей, остаются оплаченными после возврата.

Полный возврат, когда имелась в виду одна позиция

Revoke Subscription возвращает деньги и прекращает всю подписку вместе с дополнительными опциями. Если клиент оспаривает только одну опцию, Request Transaction Refund позволяет вернуть только этот SKU, с флагом revoke лишь для этой позиции. Вызов Revoke Subscription из-за жалобы на одну позицию возвращает и выручку за базовый тариф.

Чек-лист перед включением

• Убедитесь, что ваш Account Holder принял текущую версию Advanced Commerce API Addendum, и настройте оповещение на ошибку, которая приходит, когда принятие истекает.
• Генерируйте новый requestReferenceId в формате UUID для каждого запроса и используйте тот же повторно только при повторе вызова, завершившегося по тайм-ауту.
• Ставьте вызовы возвратов в очередь. Лимит составляет 5 в секунду на приложение, а ответ 429 содержит заголовок Retry-After в миллисекундах UNIX.
• Тестируйте отказы в sandbox с SIMULATE_REFUND_DECLINE и помните, что лимиты sandbox составляют 10 процентов от продакшена.
• Решайте вопрос с refundRiskingPreference в каждом случае отдельно и держите наготове обработчик данных о потреблении на 12-часовое окно, если значение остаётся true.
• Прекращайте доступ только после прихода уведомления REFUND, с его revocationDate.
• Записывайте причину, сумму и SKU каждого запроса, чтобы видеть собственную долю возвратов раньше, чем её увидит Apple.