所有文章
实战指南阅读需 8 分钟

Google Play 服务账号权限决定了谁能给你的订单退款,所以只授予够用的最小权限

只需一项 Play Console 权限,服务账号就能为任意订单退款、取消任意订阅。本文说明退款工具真正需要哪些 Google Play 服务账号权限,密钥泄露后在两家商店分别会造成什么后果,以及如何限定范围、轮换和吊销密钥。

深色桌面上一把黄铜钥匙,旁边放着笔记本电脑和手机,象征控制退款的 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 Play 服务账号权限

如何存储、轮换和吊销密钥

两家商店用不同的说法表达同一个意思:不要把密钥放进代码仓库,也不要随应用一起发布。差别在于出事之后会发生什么。

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 表示仅从仓库中移除密钥是不够的,因为在密钥本身被删除之前,任何复制过它的人都仍然可以使用它。

来源和延伸阅读

RefundHalt

App Store 和 Google Play 退款自动驾驶

继续阅读

下一项退款请求已经在路上。

读完又一封关于未能申辩退款的支持邮件所需的时间,足够您完成 RefundHalt 设置。