回填外卖单号

POST

/openapi/bwc/order/submitTakeoutNo

回填外卖单号。用户到店消费并在外卖平台下单后，渠道方将外卖平台单号回填给我方；外卖单号必须为纯数字。

校验单归属，非本渠道单返回 301。回填成功后订单推进到 Submitted（已提单）。Auto/Manual 两种模式都需要回填。

所有接口一律返回 HTTP 200，成败看 body.code：0 成功 / 3 参数错误（含时间窗、nonce 重复） / 101 签名不匹配 / 300 业务参数错误 / 301 业务校验失败 / 500 服务端或上游异常。

公共签名参数 appId/timestamp/nonce/sign 可放 URL query 或 header；签名算法：URL 参数与 body 顶层字段合并（URL 覆盖 body，剔除 sign），扁平化后按 key 字典序拼接 k1=v1&k2=v2，空值跳过，末尾直拼 secret 后取 MD5 32 位小写（UTF-8）。金额单位一律为分，比例万分比（500=5%）。

请求参数

Query 参数

Body 参数application/json必填

示例

{
    "orderNo": "BWC20261023000001",
    "takeoutOrderNo": "20261023001"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'http://prod-cn.your-api-server.com/openapi/bwc/order/submitTakeoutNo?appId=undefined&nonce=undefined&sign=undefined&timestamp=undefined' \
--header 'Content-Type: application/json' \
--data '{
    "orderNo": "BWC20261023000001",
    "takeoutOrderNo": "20261023001"
}'

返回响应

🟢200成功

*/*

Body*/*

示例

{"code": 0, "message": "success"}

🟢201成功

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

修改于 2026-10-23 13:57:04

渠道报名单分页搜索

上传凭证