代收接口

创建代收订单

请求地址

POST https://zhcpay.net/api/payment/collect?mchId={mchId}

测试信息

国家	测试商户号	密钥 Key
印度	1727808367	e0dbdbe3b5f53a792ae6a7762cd61016

测试 Token，添加到请求头 Authorization：

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtY2hJZCI6IjE3Mjc4MDgzNjciLCJpYXQiOjE3Mjc5MzI5NjB9.r9szkloixPMQdKs0lpx5g9TbLbY_Qo1PNqHMEB1CBvY

请求参数 (JSON Body)

参数名	类型	必填	示例	描述
mchOrderNo	string	是	2020092809545221	商户订单号，需保证唯一
amount	string	是	1000	订单金额
goodsName	string	否	测试商品	商品名称，不超过 50 字节
notifyUrl	string	否	https://example.com/notify	异步通知地址

Query 参数

mchId（必填）— 商户ID，拼接在 URL 中

响应参数

参数名	类型	描述
code	int	0 为成功，其他为失败
message	string	状态码不为 0 时有错误消息
data.orderNo	string	平台订单号（R 开头）
data.mchId	string	商户 ID
data.mchOrderNo	string	商户订单号
data.amount	string	订单金额
data.payUrl	string	付款链接

响应示例

json

{
  "code": 0,
  "message": "",
  "data": {
    "orderNo": "R20260324...",
    "mchId": "10001",
    "mchOrderNo": "MCH_001",
    "amount": "1000",
    "payUrl": "https://..."
  }
}

请求示例 (Python)

python

import requests
import json

url = 'https://zhcpay.net/api/payment/collect?mchId=1727808367'

data = {
    "mchOrderNo": "100002",
    "amount": "100",
    "goodsName": "测试商品",
    "notifyUrl": "https://example.com/notify"
}

headers = {
    'Content-Type': 'application/json',
    'Authorization': 'your_jwt_token_here'
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

流程说明

创建代收订单 → 根据商户配置选择上游通道 → 提交上游 → 返回支付链接

代收订单通知

订单支付成功后，平台向商户 notifyUrl 推送通知。

参数名	类型	描述
code	int	推送标识符，`1` 表示代收订单
mchId	string	商户 ID
data.mchOrderNo	string	商户订单号
data.orderNo	string	平台订单号
data.payStatus	int	支付状态：`1` 成功，`0` 未支付
data.amount	string	代收金额

通知示例

json

{
  "code": 1,
  "mchId": "169552010",
  "data": {
    "orderNo": "R202025532144555",
    "mchOrderNo": "202010215653232",
    "payStatus": 1,
    "amount": "200"
  }
}

注意

收到通知后需返回字符串 success，否则平台将连续补发 8 次。

代收接口 ​

创建代收订单 ​

请求地址 ​

测试信息 ​

请求参数 (JSON Body) ​

响应参数 ​

响应示例 ​

代收订单通知 ​

通知示例 ​