Google Play のサービス アカウント権限が注文を返金できる者を決める。だからこそ機能する最小限の権限だけを付与する
Play Console の権限ひとつで、サービス アカウントはあらゆる注文を返金し、あらゆる定期購入を解約できます。返金ツールに本当に必要な Google Play のサービス アカウント権限、漏えいしたキーが各ストアで何をできるか、そしてキーの範囲制限、ローテーション、取り消しの方法を解説します。

要点
- Google Play の Manage orders and subscriptions(注文と定期購入の管理)権限を持つ者は、注文の閲覧、注文の返金、定期購入の解約ができます。つまり、この権限を持つサービス アカウントは購入者にお金を戻せます。
- Google の Play Developer API ガイドによると、Google Play Billing API には 2 つの Play Console 権限が必要です。View financial data, orders, and cancellation survey responses と Manage orders and subscriptions です。
- Google Play Developer API の orders.refund メソッドは、3 年以内の一回限りの購入や定期購入の注文であればどれでも返金でき、revoke を true にすると購入者のアクセスは即座に終了します。
- Google Cloud のサービス アカウント キーはデフォルトでは期限切れになりません。Google は、コード リポジトリにコミットされたキーは IAM で削除する必要があり、リポジトリから消すだけでは不十分だとしています。
- Apple の In-App Purchase key では返金を発行できません。しかし App Store Server API を呼び出すことはでき、定期購入の更新日を最大 90 日延長するエンドポイントも含まれます。Apple はこの延長を取り消せないとしています。
- App Store Connect で In-App Purchase key を生成できるのは Account Holder か Admin だけです。秘密鍵のダウンロードは一度きりで、取り消したキーは復活できません。
1 つのサービス アカウントに Play Console の権限を 2 つ与えれば、そのアカウントはアプリ内のあらゆる注文を返金できます。これは設定ミスではありません。Google が Google Play Developer API をそのように設計しているのです。だからこそ、返金ツールの裏にある JSON キーは、銀行のログイン情報と同じように扱うべきです。
多くのチームは締め切りに追われる中で一度だけ設定し、最初の API 呼び出しが成功するまで手当たり次第にチェックを入れます。このガイドはその逆を行きます。返金とチャージバックの処理に本当に必要な Google Play のサービス アカウント権限、盗まれたキーで各ストアが何を許してしまうか、そして被害範囲を小さく保つ方法を示します。
Google Play のサービス アカウント権限で実際にできること
サービス アカウントはロボットのユーザーです。Google Cloud で作成し、Play Console の Users and permissions(ユーザーと権限)でそのメールアドレスを招待します。同僚を招待するのと同じ手順です。それ以降、そのアカウントは権限が許すことを API 経由で、時間を問わず、二要素認証なしで実行できます。
課金 API に必要な 2 つの権限
Google の Play Developer API ガイドは明確です。Google Play Billing API を使うには、View financial data, orders, and cancellation survey responses(財務データ、注文、解約アンケートの回答の表示)と Manage orders and subscriptions(注文と定期購入の管理)の 2 つの権限を付与します。前者は注文の読み取りと Purchases API の利用を可能にします。お金に触れるのは後者です。
| Play Console の権限 | Google が説明する許可内容 | 購入者にお金を戻せるか |
|---|---|---|
| View financial data, orders, and cancellation survey responses | 財務レポート、売上レポート、注文の閲覧、Purchases API へのアクセス、解約アンケートの回答のダウンロード | いいえ |
| Manage orders and subscriptions | 注文の閲覧、注文の返金、定期購入の解約 | はい |
| Admin(すべての権限) | 他のすべての権限に加え、ユーザーの招待と権限の変更 | はい。しかも自分に権限を追加できる |
返金権限を持つキーでできること
Google Play Developer API の orders.refund メソッドは、ユーザーの定期購入またはアプリ内購入の注文を返金します。Google によれば 3 年より古い注文は返金できません。つまり、それより新しいものはすべて返金できます。revoke を true にすれば、購入者のアクセスは即座に終了します。定期購入では、全額返金を伴う purchases.subscriptionsv2.revoke が同じ役割を果たします。
使うつもりがあるときには、これらは正しいツールです。Google 自身の不正対策ガイダンスも、チェックに通らなかった購入はタイムアウトさせず、返金して取り消すよう勧めています。問題は、1 つのアプリにしか必要のないキーが、アカウント内のすべてのアプリに対してこれを実行できてしまうことです。
キーが漏えいしたときの金銭的損失
どれだけ手間をかける価値があるか決める前に、数字を見てください。Google Play では、Manage orders and subscriptions を持つキーは 1 回の呼び出しごとに注文を返金でき、返金のたびに売上が購入者に戻ります。スクリプトは疲れません。上限は過去 3 年分の注文履歴です。
返金しても戻ってこないコスト
返金は売上を取り消します。しかし、そのサービスを提供するために使ったお金は取り消せません。返金が顧客の選択であれ攻撃者の仕業であれ、その支出は帳簿に残ります。
- すでに使ったコンピューティング: 購入者が受け取ったすべての生成、レンダリング、モデル応答の裏にある GPU とサーバーの時間。
- すでに支払った API 呼び出し: モデル提供元、地図、音声、データのベンダーによるリクエスト単位の課金。
- 払い続けるストレージ: それらのアカウントがまだサーバー上に保持しているファイルと履歴。
- すでに送ったペイアウト: それらの購入に紐づくクリエイター、アフィリエイト、販売者への支払いは、返金と一緒には戻ってきません。
Apple 側は事情が異なる
Apple の App Store Server API には返金を発行するエンドポイントがありません。返金は Apple が決めます。しかし同じ In-App Purchase key で、購読者の更新日を最大 90 日延長できます。顧客ごとに 365 日間で 2 回まで、あるいは 1 回の一括リクエストで製品のすべての有効な購読者を対象にすることもできます。Apple は延長を取り消せないとしています。その間、購読者は課金されずにアプリを使い続けるため、コンピューティング、ストレージ、API の請求は収益ゼロのまま積み上がります。
| 盗まれたキーでできること | Manage orders and subscriptions を持つ Google Play のサービス アカウント | Apple In-App Purchase key |
|---|---|---|
| 注文の返金 | はい、3 年以内の注文 | いいえ、返金するのは Apple のみ |
| 購入者のアクセス終了 | はい、返金時の revoke | いいえ |
| 定期購入の解約や延長 | 解約は可能 | 更新日を最大 90 日延長、取り消し不可 |
| 購入データの読み取り | はい、閲覧権限があれば | はい、取引と返金の履歴 |
| 返金審査への回答 | はい、orders.reviewrefund | はい、Send Consumption Information |
| 1 つのアプリへの範囲制限 | はい、アプリの権限で可能 | いいえ、キーはチームのすべてのアプリで有効 |
Google Play のサービス アカウント権限の範囲を絞る方法
Play Console はアカウントの権限とアプリの権限を分けています。アプリの権限は選択したアプリにのみ適用されます。この設定ひとつが、このリストの他のどの項目よりも安全性に貢献します。
アカウント全体ではなく、1 つのアプリに付与する
各サービス アカウントは、担当するアプリに対するアプリの権限で招待してください。あるゲームのための返金ツールに、瞑想アプリの返金権限は不要です。落とし穴がひとつあります。View financial data, orders, and cancellation survey responses はアカウント レベルにしか存在せず、アプリ レベルの同等の権限は View financial data(財務データの表示)という名前です。範囲を絞るときはアプリ レベルのほうを選んでください。
読み取りと返金を分ける
すべての処理に Manage orders and subscriptions が必要なわけではありません。注文を読むだけの分析は、閲覧権限だけを持つアカウントで実行できます。返金できるキーは、orders.refund、orders.reviewrefund、または revoke エンドポイントを実際に呼び出す 1 つのサービスだけに置いてください。
ロボットに Admin を与えない
Admin はすべての権限を付与し、Google はユーザーの招待と権限の管理もその権限に含めています。漏えいした Admin キーは自らのアクセスを広げたり、新しい人物を招待したりできます。どの返金ワークフローにも Admin は不要です。
ベンダーに接続方法を確認する
JSON キーのアップロードを求めるツールもあります。一方で、招待用に自社のサービス アカウントのメールアドレスを提供するツールもあり、その場合あなたのキーが手元を離れることはなく、Users and permissions からワンクリックでアクセスを削除できます。ベンダーが返金権限を必要とする場合は、どの権限を、どのアプリに、なぜ必要なのかを確認してください。

キーの保管、ローテーション、取り消しの方法
両ストアとも、言い方は違っても同じことを述べています。キーをコード リポジトリに置かないこと、アプリに同梱しないこと。違いが出るのは、問題が起きた後に何が起こるかです。
Google Cloud のキーは自然には期限切れにならない
Google Cloud のガイダンスは、サービス アカウント キーにはデフォルトで有効期限がないと指摘しています。定期的にローテーションし、使わなくなったキーは無効にするよう推奨しています。キーがリポジトリに入ってしまった場合、Google はできるだけ早く IAM で削除するよう求めています。リポジトリから削除するだけでは不十分だからです。Service Account Key Exposure Response の制約を DISABLE_KEY に設定すれば、Google Cloud は検出した漏えいキーを自動で無効化することもできますが、すべての漏えいを検出できる保証はありません。
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 を呼び出せなくなる | そのキーで署名したプロモーション オファーが引き換え不可になる |
簡単なチェックリスト
- 処理ごとに 1 つのサービス アカウントを使い、担当するアプリだけに対するアプリの権限で招待する。
- Manage orders and subscriptions は、実際に返金、取り消し、審査への回答を行うアカウントにだけ付与する。
- ロボット アカウントには一切 Admin を与えない。
- キーはシークレット マネージャーに保管し、リポジトリ、ビルドログ、モバイルアプリには決して置かない。
- すべてのキー、その作成者、使用しているサービスを書面で一覧化し、取り消しで返金の回答が止まらないようにする。
- 誰かがチームを離れたときやベンダーとの契約を終えたときは、Play Console の Users and permissions と App Store Connect のキーを見直す。
よくある質問
- 返金とチャージバックのために、サービス アカウントにはどの Play Console 権限が必要ですか?
- 注文の返金、定期購入の解約、注文の処理には Manage orders and subscriptions が必要で、さらに注文の閲覧権限も必要です。Google の Play Developer API ガイドは、Google Play Billing API に必要な 2 つの権限として View financial data, orders, and cancellation survey responses と Manage orders and subscriptions を挙げています。
- Google Play のサービス アカウントは注文を返金できますか?
- はい。Manage orders and subscriptions 権限を持っていれば可能です。Google のヘルプページによると、この権限で注文の閲覧、注文の返金、定期購入の解約ができ、orders.refund API メソッドは 3 年以内のあらゆる注文を返金できます。
- App Store の In-App Purchase key を入手した人は、私の顧客に返金できますか?
- いいえ。App Store Server API には返金エンドポイントがありません。返金を決めるのは Apple だからです。それでも盗まれたキーで、取引と返金の履歴の読み取り、消費情報の送信、そして定期購入の更新日を最大 90 日延長することができます。Apple はこの延長を取り消せないとしています。
- Google Play のサービス アカウント キーは期限切れになりますか?
- デフォルトではなりません。Google Cloud のガイダンスによると、作成してダウンロードしたキーは、設定しない限り有効期限がありません。定期的なローテーションと、使わなくなったキーの無効化が推奨されています。
- サービス アカウントの 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 の返金を自動処理
続きを読む
ブラジルが子どもにルートボックスを売り続けるゲームの確認を開始。そのツケが回ってくるのはルートボックスの返金です
ブラジル司法省は、年齢確認なしでルートボックスを販売する6つのゲームを監視するよう、データ保護当局に要請しました。法律が何を求めているか、Apple と Google がすでに何を求めているか、そして開封済みのボックスについてルートボックスの返金をどう見積もり、どう対応するかを解説します。
意図しないアプリ内課金は勝てない返金。対策は購入画面にある
誤タップによるアプリ内課金は、どちらのストアでも返金として戻ってきます。そして、そのタップが意図的だったと証明できる利用データはありません。Apple と Google がこれをどうラベル付けするか、コンピュートや支払いでどれだけのコストが生じるか、そして課金が発生する前に防ぐ購入画面の設計を解説します。