查询外部商家订单

我的收藏

抖音在某些场景下需要主动查询商家/第三方的订单状态，判断接单结果，进而做下一步订单流转处理。

Scope	life.trade.meal_retail_spi_query_order
权限要求
回调场景

•

Content-Type：application/json

•

X-Bytedance-Logid: 请求 logid，用于问题排查用

•

x-life-clientkey: 服务商应用的 client_key

•

X-life-sign: 请求签名，签名规则

请求示例

名称	类型	是否必填	描述	示例值
data	struct	是
- error_code	int	是	错误码，合法范围为 [0,999999]	0
- description	string	是	错误信息
- order_id	string	是	抖音订单ID
- order_out_id	string	是	外部订单ID	20001
- order_out_status	int	是	外部订单状态： •10 // 订单已创建（支付前创单） •20 // 已支付 •30 // 待接单 •40 // 已接单 •50 // 备餐中 •51 // 已出餐 •52 // 已取餐 •101 // 交易关闭（用户已取消、商家已拒单或已退款 •1 // 交易完成	101
- take_code	string	否	取餐号	9527
- take_time	int	否	预计取餐时间，秒	1678858480

响应示例

•重试（最多 15次）
◦创建订单失败（error_code!=0 ）并且 error_code!=100
◦服务商返回结果不符合协议，比如字段类型错误