上传凭证

POST

/openapi/bwc/order/submitVoucher

上传消费凭证（仅 Manual 手动模式需要）。用户消费后将凭证图片地址（URL，最长 512）提交给我方，由上游审核。

校验单归属，非本渠道单返回 301。状态约束：仅 Submitted（已提单）/ PendingReview（待审核）可提交；Auto 模式无需调用本接口。

所有接口一律返回 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",
    "voucherImg": "https://cdn.example.com/voucher/1.jpg"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'http://prod-cn.your-api-server.com/openapi/bwc/order/submitVoucher?appId=undefined&nonce=undefined&sign=undefined&timestamp=undefined' \
--header 'Content-Type: application/json' \
--data '{
    "orderNo": "BWC20261023000001",
    "voucherImg": "https://cdn.example.com/voucher/1.jpg"
}'

返回响应

🟢200成功

*/*

Body*/*

示例

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

🟢201成功

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

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

回填外卖单号

连通性验证