代收补单

请求地址

POST https://zhcpay.net/api/payment/collectSupply

请求方式：POST

请求参数 (JSON Body)

参数名	类型	必填	描述
orderNo	string	二选一	系统订单号
mchOrderNo	string	二选一	商户订单号
utr	string	是	UTR（唯一交易参考号）

提示

orderNo 和 mchOrderNo 至少填写一个。

响应参数

参数名	类型	描述
code	int	0 为成功，其他为失败
message	string	状态码不为 0 时有错误消息
data.orderNo	string	平台订单号
data.mchOrderNo	string	商户订单号
data.utr	string	提交的 UTR

响应示例

{
  "code": 0,
  "message": "",
  "data": {
    "orderNo": "R20260324...",
    "mchOrderNo": "MCH_001",
    "utr": "UTR123456"
  }
}

流程说明

查找订单（需状态 ≤ 1）→ 获取上游通道配置 → 调用上游 Supply 接口提交 UTR → 若已提交过则调用 UtrQuery 验证