Дозволи сервісного акаунта 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 їх позначають, скільки кожна з них коштує вам в обчисленнях і виплатах, і який дизайн екрана покупки зупиняє їх ще до появи списання.