外观
iOS
一、资料准备
产品方(研发)提供以下内容,后续用于支付校验
同步引用块(当前分享权限无法展开)
二、业务时序图

三、接口对接
3.1、域名环境
正式域名:https://sdkapi.zeusai.dev
测试域名:https://sdkapi-sandbox.zeusai.dev
对接期间建议先用测试环境测试,便于双方排查问题
3.1、客户端上报接口
调用时机见时序图步骤 2️⃣
接口URL:/api/s2s/v1/partner/order/apple
请求方式:POST
请求参数:
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| app_id | Int | 是 | 发行应用ID(我方提供) | 10001 |
| package_name | String | 是 | bundle id | "com.zeusai.demo" |
| adjust_id | String | 是 | 第三方adjust的 adid | "1e873a4a-7a1b-4453-9274..." |
| receipt_data | String | 是 | Jws Representation | "bGciOiJFUzI1NiIsIng1YyI6WyJNSUlF..." |
返回参数:
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | Int | http status = 200 且 code = 0 为成功状态 |
| message | String | 成功或错误信息 |
注意事项
- 网络超时情况下,需至少重试1次
3.2、App Store Server Notifications 通知设置
- 方式一:产品方(研发)服务端转发到我方回传地址的方式,贵芳需要增加
指数退避策略进行重试,避免网络抖动带来的数据丢失 - 方式二:直接在开发者后台填写我方回传地址**,注意沙盒地址和正式地址应保持一致**
接口URL:/api/callback/v1/apple/notification
请求方式:POST
请求参数:苹果通知原始内容,示例如下:
json
{
"signedPayload": "eyJhbGciOiJFUzI1NiIsIng1YyI6WyJNSUlFTURDQ0E3..."
}