Skip to content

iOS ​

一、资料准备 ​

产品方(研发)提供以下内容,后续用于支付校验

同步引用块(当前分享权限无法展开)


二、业务时序图 ​

deepseek_mermaid_20260708_424db2.png


三、接口对接 ​

3.1、域名环境 ​

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

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

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

3.1、客户端上报接口 ​

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

接口URL:/api/s2s/v1/partner/order/apple

请求方式:POST

请求参数:

参数名类型必填说明示例
app_idInt是发行应用ID(我方提供)10001
package_nameString是bundle id"com.zeusai.demo"
adjust_idString是第三方adjust的 adid"1e873a4a-7a1b-4453-9274..."
receipt_dataString是Jws Representation"bGciOiJFUzI1NiIsIng1YyI6WyJNSUlF..."

返回参数:

参数名类型说明
codeInthttp status = 200 且 code = 0 为成功状态
messageString成功或错误信息

注意事项

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

3.2、App Store Server Notifications 通知设置 ​

  • 方式一:产品方(研发)服务端转发到我方回传地址的方式,贵芳需要增加指数退避策略进行重试,避免网络抖动带来的数据丢失
  • 方式二:直接在开发者后台填写我方回传地址**,注意沙盒地址和正式地址应保持一致**

接口URL:/api/callback/v1/apple/notification

请求方式:POST

请求参数:苹果通知原始内容,示例如下:

json
{
  "signedPayload": "eyJhbGciOiJFUzI1NiIsIng1YyI6WyJNSUlFTURDQ0E3..."
}