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。
- Google Play Developer API 的 orders.refund 方法可為最長 3 年內的任何一次性購買或訂閱訂單退款;若將 revoke 設為 true,還會立即終止買家的存取權。
- Google Cloud 服務帳戶金鑰預設不會過期。Google 表示,提交到程式碼存放區的金鑰必須在 IAM 中刪除,只從存放區移除是不夠的。
- Apple 的 In-App Purchase key 無法發起退款,但可以呼叫 App Store Server API,包括將訂閱續訂日期最多延後 90 天的端點,而 Apple 表示這種延期無法撤回。
- 只有 Account Holder 或 Admin 才能在 App Store Connect 中產生 In-App Purchase key,私密金鑰只能下載一次,而且已撤銷的金鑰無法恢復。
給一個服務帳戶兩項 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(所有權限) | 其他所有權限,加上邀請使用者及變更其權限 | 是,而且能替自己授予更多權限 |
擁有退款權限的金鑰能做什麼
Google Play Developer API 的 orders.refund 方法會為使用者的訂閱或應用程式內購買訂單退款。Google 表示超過 3 年的訂單無法退款,也就是說比這更新的訂單都可以。將 revoke 設為 true,買家的存取權就會立即終止。至於訂閱,搭配全額退款的 purchases.subscriptionsv2.revoke 也能達到同樣效果。
在你確實打算使用時,這些都是正確的工具。Google 自己的防詐騙指南也建議,對未通過檢查的購買應退款並撤銷,而不是放任它逾時。問題在於,一把只需要服務一個應用程式的金鑰,卻能對你帳戶下的所有應用程式這麼做。
金鑰外洩會讓你損失多少錢
在決定投入多少心力之前,先算一筆帳。在 Google Play 上,持有 Manage orders and subscriptions 的金鑰可以一次呼叫退一筆訂單,每筆退款都會把這筆銷售款退回給買家。指令碼不會累。上限就是你過去 3 年的所有訂單紀錄。
退款退不回來的成本
退款撤回的是這筆銷售,撤回不了你為了提供服務已經花掉的錢。不論退款出自客戶本人還是攻擊者,這些支出都會留在你的帳上。
- 已經耗用的運算資源:買家收到的每一次生成、算圖或模型回應背後的 GPU 和伺服器時間。
- 已經付費的 API 呼叫:模型供應商、地圖、語音或資料供應商按請求計費的費用。
- 持續付費的儲存空間:這些帳戶仍存放在你伺服器上的檔案和歷史紀錄。
- 已經發出的分潤:與這些購買相關的創作者、聯盟夥伴或賣家分潤,不會隨著退款一起回來。
Apple 這邊的情況不同
Apple 的 App Store Server API 沒有發起退款的端點。退款由 Apple 決定。但同一把 In-App Purchase key 可以把訂閱者的續訂日期最多延後 90 天,每位客戶在 365 天內最多 兩次,也可以透過一次大量請求替某項產品的所有有效訂閱者延期。Apple 表示延期無法撤回。在這段期間,訂閱者不會被收費卻仍在使用你的應用程式,你的運算、儲存和 API 帳單在沒有營收的情況下照樣累積。
| 遭竊金鑰能做什麼 | 持有 Manage orders and subscriptions 的 Google Play 服務帳戶 | 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 要求盡快在 IAM 中刪除它,因為只從存放區刪除是不夠的。當 Service Account Key Exposure Response 限制設為 DISABLE_KEY 時,Google Cloud 也能自動停用它偵測到的外洩金鑰,但它不保證能抓到每一次外洩。
Apple 金鑰只能下載一次,撤銷即永久
只有 Account Holder 或 Admin 才能產生 In-App Purchase key。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。
- 金鑰存放在密鑰管理工具中,絕不放進存放區、建置記錄或行動應用程式。
- 書面記錄每把金鑰、建立者以及使用它的服務,避免撤銷時讓退款回覆中斷。
- 每當有人離開團隊或停用某個供應商時,檢視 Play Console 的 Users and permissions 和 App Store Connect 中的金鑰。
常見問題解答
- 服務帳戶處理退款和退單需要哪些 Play Console 權限?
- 它需要 Manage orders and subscriptions 來為訂單退款、取消訂閱及處理訂單,另外還需要訂單的查看權限。Google 的 Play Developer API 指南將 View financial data, orders, and cancellation survey responses 和 Manage orders and subscriptions 列為 Google Play Billing API 必備的兩項權限。
- 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 的退款自動駕駛