通知支付结果(SPI)
收藏
我的收藏对应能力:景区支付通知
接口说明
抖音侧通知第三方支付成功。ClientKey 维度默认配置是 抖音侧支付成功后 通知第三方创单,不额外通知支付成功。
通知类型的接口 请勿返回业务类型的错误(譬如订单不存在),返回系统类型的错误抖音侧可以重试。
- •如果抖音调用三方创建订单失败,则不会有支付通知
- •如果创建订单和支付结果合并则可以不对接该接口
基本信息
Scope | life.capacity.trip_order_pay_notify | |||
权限要求 | 景区行业解决方案-景区支付通知 | |||
回调场景 | 景区支付结果 |
请求头
- •Content-Type:
application/json
- •X-Bytedance-Logid: 请求 logid, 用于问题排查用
- •x-life-clientkey: 服务商应用的 client_key
- •X-life-sign: 请求签名,签名规则
请求参数
名称 | 类型 | 是否必填 | 描述 | 示例值 |
order_id | string | 是 | 抖音侧订单 ID | 100001 |
order_out_id | string | 是 | 第三方订单 ID | 200001 |
pay_time_unix | int | 是 | 事件时间戳,秒 | 1678858480 |
请求示例
响应参数
名称 | 类型 | 是否必填 | 描述 | 示例值 |
data | struct | 是 | | |
- error_code | int | 是 | 错误码,合法范围为 [0,999999] | 0 |
- description | string | 是 | 错误信息 | |
- confirm_info | struct | 是 | 确认接单信息 | |
-- confirm_mode | int | 是 | 接单模式,1 同步接单,2 异步接单 | 1 |
-- confirm_result | int | 否 | 接单结果,同步接单时必填,1 接单,2 拒单 | 1 |
响应示例
{ "data": { "error_code": 0, "description": "", "confirm_info": { "confirm_mode": 1, "confirm_result": 1 } } }
错误码
- •重试(最多 12次)
- ◦创建订单失败(error_code!=0 并且 error_code!=1)
- ◦服务商返回结果不符合协议,比如字段类型错误
error_code | description | 备注 |
0 | | 成功 |
100 | ... | 抖音侧需要重试,其他错误码抖音不重试 |