安卓

一、资料准备

产品方（研发）提供以下内容，后续用于支付校验

同步引用块（当前分享权限无法展开）

---

二、业务时序图

---

三、接口对接

3.1、域名环境

正式域名：https://sdkapi.zeusai.dev

测试域名：https://sdkapi-sandbox.zeusai.dev

对接期间建议先用测试环境测试，便于双方排查问题

3.1、客户端上报接口

调用时机见时序图步骤 2️⃣

接口URL：/api/s2s/v1/partner/order/google

请求方式：POST

请求参数：

参数名	类型	必填	说明	示例
app_id	Int	是	发行应用ID（我方提供）	10001
package_name	String	是	包名	"com.zeusai.demo"
adjust_id	String	是	第三方adjust的 adid	"1e873a4a-7a1b-4453-9274..."
receipt_data	String	是	票据里的Original Json	"{orderId:xxx,...}"

返回参数：

参数名	类型	说明
code	Int	http status = 200 且 code = 0 为成功状态
message	String	成功或错误信息

注意事项

• Receiption Data 为 Purchase 对象中的 Original Purchase Json，示例如下

{
  "orderId": "GPA.3398-9062-4940-xxxx",
  "packageName": "com.zeusai.demo",
  "productId": "opt1",
  "purchaseTime": 1782987790920,
  "purchaseState": 0,
  "purchaseToken": "nochajllnojjbangbonjedhc.AO-J1OxL...",
  "obfuscatedAccountId": "1",
  "quantity": 1,
  "acknowledged": false
}

• 网络超时情况下，需至少重试1次

3.2、RTDN通知设置

• 方式一：产品方（研发）服务端转发到我方回传地址的方式，贵芳需要增加指数退避策略进行重试，避免网络抖动带来的数据丢失
• 方式二：通过Google Cloud Platform 的1个主题创建多个订阅（Subscriptions） 的形式转发给我方，在其中1个订阅填我方回传地址

建议采用方式二

接口URL：/api/callback/v1/google/notification

请求方式：POST

请求参数：谷歌RTDN的原始内容，示例如下：

{
    "message": {
        "data": "eyJ2ZXJzaW9uIjoiMS4wIiwicGFja2FnZU5hbWUiOiJjb20uaHVhaG9vLnRyY...",
        "messageId": "20541240703060933",
        "message_id": "20541240703060933",
        "publishTime": "2026-07-02T10:23:11.407Z",
        "publish_time": "2026-07-02T10:23:11.407Z"
    },
    "subscription": "projects/zeusai-app-896b5/subscriptions/play-billing-sub"
}