通知外部商家取消订单
接口说明
抖音侧通知第三方取消订单。
通知类型的接口 请勿返回业务类型的错误(譬如订单不存在)
使用限制
无
基本信息
Scope | life.capacity.comprehensive_retail_cancel_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 | 1 |
cancel_type | int | 是 | 取消类型,1 支付前取消,2 支付后取消 | 1 |
cancel_order_time_unix | int | 是 | 取消订单的时间戳,秒 | 1678859379 |
请求示例
{ "order_id":"111", "order_out_id": "1", "cancel_type":1, "cancel_order_time_unix": 1678859379 }
响应参数
名称 | 类型 | 是否必填 | 描述 | 示例值 |
data | struct | 是 | | |
- error_code | int | 是 | 错误码,合法范围为 [0,999999] | 0 |
- description | string | 是 | 错误信息 | |
响应示例
{ "data": { "error_code": 0, "description": "", } }
错误码
error_code | description | 备注 |
0 | success | 成功 |
300 | ... | 抖音侧需要重试,其他错误码抖音不重试 |
400~499 | | 其他自定义错误 |