SuperAPI AI 工具集

gplay-purchase-verification

通用与其它

查看项目

更新于 10-15 21:06

技能介绍

用途:在后端服务端验证 Google Play 应用内购买与订阅,防止客户端校验被绕过,用于防欺诈、确认用户实际付款、检查订阅状态以及处理退款和取消。需使用带权限的服务账号(创建服务账号、授予 Service Account User 角色、下载 JSON 密钥,并在 Play Console 的用户与权限中授予服务账号访问应用)。

主要能力:验证商品购买(gplay purchases products get --package com.example.app --product-id premium_upgrade --token <PURCHASE_TOKEN>),返回 purchaseState(0 已购、1 已取消、2 待处理)与 consumptionState;确认购买(gplay purchases products acknowledge,未确认的购买将在 3 天后退款);消耗型商品使用 consume;订阅查询推荐 v2(gplay purchases subscriptionsv2 get),v1 为遗留接口;支持取消、延迟、撤销订阅,查询已作废购买,查询与批量查询订单,退款需 --confirm 且不可逆;实时开发者通知(RTDN)可用 gplay rtdn setup 与 gplay rtdn decode 搭建与解析,订阅状态含 0 有效到 5 过期,支付状态含 0 待处理到 3 待处理升级降级。

使用方式:后端集成 Node.js/Express 或 Python/Flask,使用服务账号与 androidpublisher 作用域调用 API;典型流程为客户端发起购买后将 token 发给服务器,服务器验证、确认、授予权益并存储 token,同时监听 RTDN 取消与续订事件。常见错误:401 服务账号未授权、404 token 无效或过期、410 已退款或取消;404/410 不应重试。测试时可使用测试账号与 android.test.purchased。

限制与安全:务必在服务端验证,不可仅信客户端;不要暴露服务账号凭证;3 天内完成确认;使用 HTTPS、限流并记录所有验证尝试;忽略已作废购买会带来风险;不得存储信用卡信息。资料未提供具体价格。