渠道报名下单

渠道报名下单。渠道侧先创建自己的订单生成 channelOrderNo，再调用本接口向我方报名。

幂等：channelCode + channelOrderNo 唯一，重复调用返回同一单，不会重复报名。longitude/latitude 为风控透传字段（可选，成对传）；clientIp 由服务端自动取远程 IP，无需传。

失败分支：301 活动不存在/已结束/不在活动时间窗/上游拒单；500 上游异常可间隔重试（重试前先按 channelOrderNo 查单避免重复报名）。

所有接口一律返回 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%）。

{ "activityId": "act_8888", "channelOrderNo": "CH20261023001", "channelUserId": "user_10001", "latitude": 31.863916, "longitude": 117.285735, "mobile": "13800138000", "storeId": "store_123" }

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

*/*

Body*/*

示例

{"code": 0, "message": "success", "data": {"orderNo": "BWC20261023000001", "channelCode": "200009", "rebateMode": "Manual", "channelOrderNo": "CH20261023001", "channelUserId": "user_10001", "mobile": "13800138000", "activityId": "act_8888", "storeId": "store_123", "storeName": "老乡鸡（步行街店）", "platformCode": "mt", "mealPrice": 3000, "commissionRate": 500, "commissionCap": 500, "commissionAmount": 0, "status": "Registered", "reason": "", "takeoutOrderNo": ""}}

🟢201成功

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

请求参数

请求示例代码

返回响应