兜底核销通知
平台兜底核销时,通知开发者
注意:
- •此通知仅针对平台兜底核销逻辑
- •此通知目前仅混合双开外卖配送/自提场景适用
- •平台兜底核销目前走白名单机制,需要接入请联系产运同学配置appid和推送兜底核销时间间隔
- •此通知复用混合双开外卖支付成功通知回调url,type增加履约完成枚举,详见下文请求参数
使用限制
白名单机制
接口说明
- •由于网络波动等原因,可能会产生重复的通知消息,接入方需要做好幂等,正确处理。
- •在开发者服务端收到回调且处理成功后,需要按以下正常返回示例返回并且 HTTP 响应状态码设为 200,否则会认为通知失败进行重试。
基本信息
基本信息 | ||||
HTTP URL | 在解决方案配置-消息通知中指定的回调地址,配置方式参考解决方案配置文 档 | |||
HTTP Method | POST | |||
请求头
请求参数
参数名称 | 类型 | 是否必填 | 描述 | 示例值 |
msg | string | 是 | 订单相关信息的 json 字符串 | 见请求示例 |
type | string | 是 | 枚举值 fulfillment | fulfillment |
version | string | 是 | 固定值:"2.0"。 回调版本,用于开发者识别回调参数的变更 | 2.0 |
msg 字段
字段名 | 类型 | 是否必填 | 描述 | 示例值 |
app_id | string | 是 | 小程序 app_id | ttcxxxxxx |
status | string | 是 | 支付结果状态,目前有两种状态: •"SUCCESS" (支付成功 ) •"CANCEL" (支付取消) | SUCCESS |
order_id | string | 是 | 抖音开平侧订单id,长度 <= 64byte | ot7057416814925531429 |
event_time | int64 | 是 | 用户支付成功/支付取消时间戳,单位为毫秒 | 1643189272388 |
out_order_id | string | 是 | 开发者系统生成的订单号,与抖音开平交易单号 order_id 唯一关联,长度 <= 64byte | ext_order_no_164318867591 |
out_fulfill_order_id | string | 是 | 外部履约单号 | ot7057416814925531429 |
reason | string | 是 | 原因 | 系统兜底核销 |
请求示例
curl --location --request POST 'https://xxxxxxx.net/api/v2/result_callback?timestamp=1345678901234&nonce=iuy987q4htafreqw' \--header 'Content-Type: application/json' \ --data-raw='{ "version": "2.0", //本次固定为2.0, 通过版本信息识别,用不同的结构体去解析上述关键参数 "msg": "{\"app_id\":\"ttcce0ba5d53axxxxx\",\"status\":\"已送达\",\"order_id\":\"ots760078130087367xxxxx\",\"cp_extra\":\"{\\\"hostName\\\":\\\"Douyin\\\",\\\"use_trade_delivery\\\":1234511111}\",\"message\":\"\",\"event_time\":1769695801525,\"out_fulfill_order_id\":\"out_fulfill_order_id_ots76007813008736771006110\",\"out_order_id\":\"waimai_ots76007813008736771006110\",\"reason\":\"系统兜底核销\"}", "type": "fulfillment" }'
msg 字段内容示例
{ "app_id": "ttcce0ba5d53aa5c0f01", "status": "已送达", "order_id": "ots76007813008736771006110", "cp_extra": "{\"hostName\":\"Douyin\",\"use_trade_delivery\":1234567890}", "message": "", "event_time": 1769695801525, "out_fulfill_order_id": "out_fulfill_order_id_ots76007813008736771006110", "out_order_id": "waimai_ots76007813008736771006110", "reason": "系统兜底核销" }
响应参数
参数名称 | 类型 | 描述 | 示例值 |
err_no | int64 | 错误码 | 0 |
err_tips | string | 错误提示 | success |
响应示例
正常示例
//正常返回响应且http状态码为200 //注意://正常返回时一定要保证err_no和err_tips为下面标准返回方式,不然都认为失败,将会重试{"err_no": 0,"err_tips": "success"}
异常示例
//异常响应或http状态码为非200, //字节服务端会不断重试{"err_no": 1, //非0"err_tips": "system error" //非success}
