Разрешения сервисного аккаунта Google Play решают, кто может возвращать деньги за ваши заказы, поэтому выдавайте самый узкий рабочий набор
Одно разрешение в Play Console позволяет сервисному аккаунту вернуть деньги за любой заказ и отменить любую подписку. Разбираем, какие разрешения сервисного аккаунта Google Play действительно нужны инструментам для возвратов, что может сделать утекший ключ в каждом магазине и как ограничивать, ротировать и отзывать ключи.

Главное
- Разрешение Google Play Manage orders and subscriptions (управление заказами и подписками) позволяет просматривать заказы, возвращать за них деньги и отменять подписки, поэтому любой сервисный аккаунт с этим разрешением может вернуть деньги вашим покупателям.
- В руководстве Google по Play Developer API сказано, что для Google Play Billing API нужны два разрешения Play Console: View financial data, orders, and cancellation survey responses и Manage orders and subscriptions.
- Метод orders.refund в Google Play Developer API может вернуть деньги за любой заказ разовой покупки или подписки возрастом до 3 лет, а при revoke со значением true доступ покупателя прекращается немедленно.
- Ключи сервисных аккаунтов Google Cloud по умолчанию не истекают, и Google указывает, что ключ, попавший в репозиторий кода, нужно удалить в IAM, потому что удаления из репозитория недостаточно.
- In-App Purchase key от Apple не может оформлять возвраты, но может вызывать App Store Server API, включая методы, которые продлевают дату обновления подписки на срок до 90 дней, и Apple заявляет, что такое продление нельзя отменить.
- Сгенерировать In-App Purchase key в App Store Connect может только Account Holder или Admin, закрытый ключ скачивается лишь один раз, а отозванный ключ восстановить нельзя.
Дайте одному сервисному аккаунту два разрешения в Play Console, и он сможет вернуть деньги за любой заказ в вашем приложении. Это не ошибка настройки. Именно так Google спроектировала Google Play Developer API, и поэтому JSON-ключ вашего инструмента для возвратов заслуживает той же защиты, что и вход в ваш банк.
Большинство команд настраивают это один раз, в спешке, отмечая всё, что помогло первому вызову API пройти успешно. Это руководство идёт обратным путём. В нём перечислено, какие разрешения сервисного аккаунта Google Play действительно нужны для работы с возвратами и чарджбэками, что каждый магазин позволяет сделать украденному ключу и как держать радиус поражения минимальным.
Что на самом деле позволяют разрешения сервисного аккаунта Google Play
Сервисный аккаунт это пользователь-робот. Вы создаёте его в Google Cloud, а затем приглашаете его адрес электронной почты в Play Console в разделе Users and permissions (пользователи и разрешения), так же как пригласили бы коллегу. С этого момента он может делать всё, что разрешено, через API, в любое время суток и без второго фактора.
Два разрешения, которые требуют платёжные API
Руководство Google по Play Developer API говорит об этом конкретно. Чтобы пользоваться Google Play Billing API, нужно выдать два разрешения: View financial data, orders, and cancellation survey responses (просмотр финансовых данных, заказов и ответов на опрос об отмене) и Manage orders and subscriptions. Первое позволяет аккаунту читать заказы и пользоваться Purchases API. Второе как раз и касается денег.
| Разрешение Play Console | Что оно позволяет, по словам Google | Может ли оно вернуть деньги покупателям |
|---|---|---|
| View financial data, orders, and cancellation survey responses | Просмотр финансовых отчётов, отчётов о продажах и заказов, доступ к Purchases API, загрузка ответов на опрос об отмене | Нет |
| Manage orders and subscriptions | Просмотр заказов, возврат денег за заказы, отмена подписок | Да |
| Admin (все разрешения) | Все остальные разрешения, а также приглашение пользователей и изменение их разрешений | Да, и оно может выдать себе больше прав |
Что может ключ с правом на возврат
Метод orders.refund в Google Play Developer API возвращает деньги за заказ подписки или встроенной покупки пользователя. Google указывает, что за заказы старше 3 лет вернуть деньги нельзя, а значит, за всё более новое можно. Установите revoke в true, и доступ покупателя прекратится немедленно. Для подписок ту же задачу решает purchases.subscriptionsv2.revoke с полным возвратом.
Это правильные инструменты, когда вы применяете их намеренно. Собственные рекомендации Google по борьбе с мошенничеством советуют вернуть деньги и отозвать покупку, не прошедшую ваши проверки, а не ждать истечения срока. Проблема в ключе, который может делать это для всех приложений в вашем аккаунте, хотя ему нужно было лишь одно.
Во что вам может обойтись утекший ключ
Посчитайте цифры, прежде чем решать, сколько усилий на это потратить. В Google Play ключ с Manage orders and subscriptions может возвращать деньги за заказы по одному вызову за раз, и каждый возврат отдаёт сумму продажи покупателю. Скрипт не устаёт. Предел ущерба это вся ваша история заказов за последние 3 года.
Расходы, которые не возвращаются вместе с возвратом
Возврат отменяет продажу. Он не отменяет того, что вы потратили на её обслуживание. Эти расходы остаются в вашей отчётности, независимо от того, был ли возврат решением клиента или злоумышленника.
- Уже потраченные вычисления: время GPU и серверов за каждой генерацией, рендером или ответом модели, которые получил покупатель.
- Уже оплаченные вызовы API: плата за каждый запрос поставщикам моделей, карт, распознавания речи или данных.
- Хранилище, за которое вы продолжаете платить: файлы и история, которые эти аккаунты по-прежнему хранят на ваших серверах.
- Уже отправленные выплаты: выплаты авторам, партнёрам или продавцам, связанные с этими покупками, не возвращаются вместе с возвратом.
У Apple картина другая
В App Store Server API от Apple нет метода, который оформляет возврат. Решения о возвратах принимает Apple. Но тот же In-App Purchase key может продлить дату обновления подписки на срок до 90 дней, дважды за 365 дней для каждого клиента, или для всех активных подписчиков продукта одним массовым запросом. Apple заявляет, что продление нельзя отменить. В эти дни подписчик не платит, но продолжает пользоваться вашим приложением, поэтому счета за вычисления, хранилище и API продолжают расти без какой-либо выручки.
| Что может украденный ключ | Сервисный аккаунт Google Play с Manage orders and subscriptions | Apple In-App Purchase key |
|---|---|---|
| Вернуть деньги за заказ | Да, за заказы возрастом до 3 лет | Нет, возвраты делает только Apple |
| Прекратить доступ покупателя | Да, через revoke при возврате | Нет |
| Отменить или продлить подписки | Отменить, да | Продлить дату обновления до 90 дней, без возможности отмены |
| Читать данные о покупках | Да, с разрешением на просмотр | Да, историю транзакций и возвратов |
| Отвечать на запросы о возврате | Да, orders.reviewrefund | Да, Send Consumption Information |
| Ограничить одним приложением | Да, через разрешения на уровне приложения | Нет, ключ работает во всех приложениях вашей команды |
Как ограничить разрешения сервисного аккаунта Google Play
Play Console разделяет разрешения на уровне аккаунта и разрешения на уровне приложения. Разрешения на уровне приложения действуют только для выбранных вами приложений. Эта одна настройка делает для вашей безопасности больше, чем любой другой пункт этого списка.
Выдавайте права на одно приложение, а не на весь аккаунт
Приглашайте каждый сервисный аккаунт с разрешениями на уровне приложения только для тех приложений, которые он обслуживает. Инструменту возвратов для одной игры не нужны права на возврат в вашем приложении для медитации. Одна ловушка: View financial data, orders, and cancellation survey responses существует только на уровне аккаунта, а его аналог на уровне приложения называется View financial data. При ограничении прав выбирайте вариант на уровне приложения.
Разделяйте чтение и возвраты
Не каждой задаче нужно Manage orders and subscriptions. Аналитика, которая только читает заказы, может работать на аккаунте с правами на просмотр и ничем больше. Держите ключ с правом на возврат только в том единственном сервисе, который действительно вызывает orders.refund, orders.reviewrefund или методы revoke.
Никогда не давайте роботу Admin
Admin выдаёт все разрешения, и Google перечисляет среди его прав приглашение пользователей и управление их разрешениями. Утекший ключ с Admin может расширить собственный доступ или пригласить кого-то нового. Ни одному процессу возвратов он не нужен.
Спрашивайте поставщиков, как они подключаются
Некоторые инструменты просят загрузить JSON-ключ. Другие дают вам адрес электронной почты собственного сервисного аккаунта для приглашения, так что ни один ваш ключ не покидает вашего контроля, и вы можете отключить их доступ в Users and permissions одним щелчком. Если поставщику нужны права на возврат, спросите, какие именно разрешения, для каких приложений и зачем.

Как хранить, ротировать и отзывать ключи
Оба магазина говорят одно и то же разными словами. Не храните ключи в репозитории кода и не встраивайте их в приложение. Различия начинаются после того, как что-то пошло не так.
Ключи Google Cloud не истекают сами по себе
В рекомендациях Google Cloud отмечено, что ключи сервисных аккаунтов по умолчанию не имеют срока действия. Google советует регулярно их ротировать и отключать ключи, которыми вы больше не пользуетесь. Если ключ попал в репозиторий, Google велит как можно скорее удалить его в IAM, потому что удаления из репозитория недостаточно. Google Cloud также может автоматически отключать обнаруженные утекшие ключи, если ограничение Service Account Key Exposure Response установлено в DISABLE_KEY, но не гарантирует, что поймает каждую утечку.
Ключи Apple скачиваются один раз и отзываются навсегда
Сгенерировать In-App Purchase key может только Account Holder или Admin. Apple хранит открытую часть, вы скачиваете закрытый файл .p8 один раз, и Apple не хранит его копию. Если вы подозреваете, что ключ скомпрометирован, Apple велит немедленно отозвать его в App Store Connect в разделе Users and Access, Integrations, In-App Purchase. Отозванный ключ восстановить нельзя, а отзыв также останавливает погашение промопредложений, подписанных этим ключом, поэтому обновите эти предложения до отзыва или сразу после него.
| Задача | Сервисный аккаунт Google Play | Apple In-App Purchase key |
|---|---|---|
| Кто может его создать | Создаётся в Google Cloud, затем приглашается в Play Console через Users and permissions | Account Holder или Admin |
| Можно ли скачать секрет повторно | Вы создаёте новый ключ | Нет, только одно скачивание |
| Срок действия по умолчанию | Нет | Нет, пока вы его не отзовёте |
| Как быстро отключить доступ | Удалить ключ в IAM или удалить аккаунт в Play Console | Отозвать ключ в App Store Connect |
| Побочные эффекты отключения доступа | Любой инструмент, использующий этот аккаунт, перестаёт вызывать API | Промопредложения, подписанные этим ключом, перестают погашаться |
Короткий чек-лист
- Один сервисный аккаунт на одну задачу, приглашённый с разрешениями на уровне приложения только для тех приложений, которые он обслуживает.
- Manage orders and subscriptions только у того аккаунта, который действительно возвращает деньги, отзывает покупки или отвечает на запросы о возврате.
- Никакого Admin ни у одного аккаунта-робота.
- Ключи в менеджере секретов, никогда в репозитории, журнале сборки или мобильном приложении.
- Письменный список всех ключей: кто создал каждый и какой сервис его использует, чтобы отзыв не сломал ваши ответы по возвратам.
- Проверка Users and permissions в Play Console и ключей в App Store Connect каждый раз, когда кто-то уходит из команды или вы отказываетесь от поставщика.
Частые вопросы
- Какие разрешения Play Console нужны сервисному аккаунту для возвратов и чарджбэков?
- Ему нужно Manage orders and subscriptions, чтобы возвращать деньги за заказы, отменять подписки и работать с заказами, а также доступ на просмотр заказов. В руководстве Google по Play Developer API указаны два разрешения, которые требуют Google Play Billing API: View financial data, orders, and cancellation survey responses и Manage orders and subscriptions.
- Может ли сервисный аккаунт Google Play возвращать деньги за заказы?
- Да, если у него есть разрешение Manage orders and subscriptions. На странице справки Google сказано, что это разрешение позволяет просматривать заказы, возвращать за них деньги и отменять подписки, а метод API orders.refund возвращает деньги за любой заказ возрастом до 3 лет.
- Может ли кто-то с моим In-App Purchase key из App Store вернуть деньги моим клиентам?
- Нет. В App Store Server API нет метода для возврата, потому что решения о возвратах принимает Apple. Но украденный ключ всё равно может читать историю транзакций и возвратов, отправлять информацию о потреблении и продлевать даты обновления подписок на срок до 90 дней, и Apple заявляет, что это нельзя отменить.
- Истекают ли ключи сервисных аккаунтов Google Play?
- По умолчанию нет. В рекомендациях Google Cloud сказано, что созданные и скачанные ключи не имеют срока действия, если вы его не настроите, и Google советует регулярно ротировать ключи и отключать те, которыми вы больше не пользуетесь.
- Что делать, если JSON-ключ моего сервисного аккаунта попал в GitHub?
- Немедленно удалите ключ в Google Cloud IAM и создайте новый. Google указывает, что удаления ключа из репозитория недостаточно, потому что любой, кто его скопировал, сможет им пользоваться, пока сам ключ не удалён.
Источники и дополнительное чтение
- Play Console Help: Add developer account users and manage permissions
- Google Play Developer API: Getting started (service accounts and required permissions)
- Google Play Developer API: orders.refund reference
- Android Developers: Fight fraud and abuse
- Google Cloud: Best practices for managing service account keys
- Apple Developer: Creating API keys to authorize API requests
- App Store Connect Help: Generate keys for in-app purchases
- Apple Developer: Extending the renewal date for auto-renewable subscriptions
RefundHalt
Автопилот возвратов для App Store и Google Play
Читайте дальше
Бразилия проверяет, какие игры всё ещё продают лутбоксы детям, а счёт в итоге приходит через возвраты за лутбоксы
Министерство юстиции Бразилии попросило орган по защите данных следить за шестью играми, которые продают лутбоксы без проверки возраста. Что требует закон, что уже требуют Apple и Google и как оценивать и обрабатывать возвраты за лутбоксы, если лутбокс уже открыт.
Случайные встроенные покупки: возвраты, которые не выиграть. Решение находится на экране покупки
Случайные встроенные покупки возвращаются в обоих магазинах как возвраты, и никакие данные об использовании не докажут, что нажатие было намеренным. Разбираем, как Apple и Google их помечают, во что они обходятся вам в вычислениях и выплатах, и какой дизайн экрана покупки останавливает их до того, как появится списание.