PayHub 聚合支付 API
一套接口接入微信支付、支付宝、银联等主流支付渠道,支持扫码支付、收银台跳转、异步回调与退款对账。
产品介绍
PayHub 是面向电商、SaaS 与线下门店的聚合支付接入平台。开发者只需对接一套 RESTful API,即可同时支持微信扫码、支付宝扫码、银联等多种支付方式,无需分别对接各渠道。
https://www.dkzhushou.cn快速开始
1. 注册商户账号
前往 商户后台 注册并完成企业认证,在「开发者设置」中获取 App-Id 与 Key-Secret。
2. 构造请求
每个请求需在 HTTP Header 中携带以下字段:
| Header | 说明 | 示例 |
|---|---|---|
App-Id | 商户应用 ID | APP31CBD54C560A0D59 |
Key-Id | API 密钥 ID | ak_1be70dbea4c44d5d |
Timestamp | 当前 Unix 时间戳(秒) | 1731672000 |
Nonce | 随机字符串,防重放 | a1b2c3d4e5f6 |
Sign | HMAC-SHA256 签名 | 见下方 |
签名认证
签名算法:将 App-Id + Timestamp + Nonce + 请求体JSON 拼接后,用 Key-Secret 做 HMAC-SHA256,输出十六进制小写字符串。
// Node.js 示例 const crypto = require('crypto'); const raw = appId + timestamp + nonce + JSON.stringify(body); const sign = crypto.createHmac('sha256', keySecret) .update(raw).digest('hex');
POST 创建支付订单
/openapi/v1/pay/create
创建一笔支付订单,返回收银台链接或渠道支付码。
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
subject | string | 是 | 订单标题,最长 128 字 |
amount | number | 是 | 金额(元),最小 0.01 |
channel | string | 是 | 渠道:wxpay_native / alipay_qr |
out_trade_no | string | 是 | 商户系统唯一订单号 |
notify_url | string | 否 | 支付结果异步回调地址 |
return_url | string | 否 | 支付完成前端跳转地址 |
请求示例
curl -X POST 'https://www.dkzhushou.cn/openapi/v1/pay/create' \ -H 'App-Id: APP31CBD54C560A0D59' \ -H 'Key-Id: ak_1be70dbea4c44d5d' \ -H 'Timestamp: 1731672000' \ -H 'Nonce: a1b2c3d4' \ -H 'Sign: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \ -d '{ "subject": "订单测试", "amount": 0.01, "channel": "wxpay_native", "out_trade_no": "TEST20261115001", "notify_url": "https://your-domain.com/notify" }'
响应示例
{
"code": 0,
"message": "ok",
"data": {
"order_no": "O2026111522190543BFF862262A",
"pay_url": "https://qr.shouqianba.com/gateway/xxx",
"amount": 0.01,
"status": "pending"
}
}
GET 查询订单
/openapi/v1/pay/query?orderNo=xxx
主动查询订单状态。建议在接收异步回调失败时,用此接口主动查询补单。
| 字段 | 说明 |
|---|---|
orderNo | PayHub 订单号(创建接口返回) |
POST 申请退款
/openapi/v1/refund/create
对已支付订单发起退款,支持部分退款。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
order_no | string | 是 | PayHub 订单号 |
refund_amount | number | 是 | 退款金额(元) |
reason | string | 否 | 退款原因 |
异步回调通知
支付成功后,PayHub 会向商户配置的 notify_url 发送 POST 请求,Body 为 JSON。商户需返回 success 字符串表示接收成功,否则平台会重试。
回调参数
{
"order_no": "O2026111522190543BFF862262A",
"out_trade_no": "TEST20261115001",
"amount": 0.01,
"status": "paid",
"paid_at": "2026-11-15 22:20:16",
"channel_trade_no": "7895086871386318",
"sign": "..."
}
错误码
| 错误码 | 含义 | 处理建议 |
|---|---|---|
0 | 成功 | — |
401 | 签名错误或身份未通过 | 检查 App-Id / Key-Secret / 签名算法 |
403 | 无权限访问该接口 | 联系管理员开通权限 |
404 | 订单不存在 | 检查 orderNo 是否正确 |
429 | 请求过于频繁 | 降低调用频率 |
500 | 服务器内部错误 | 重试或联系技术支持 |
更新日志
2026-11-15 · 正式上线,支持微信扫码、支付宝扫码支付,异步回调自动入账。
API 在线调试
本工具提供一个沙箱环境,帮助开发者在正式接入前验证接口连通性与参数格式。填写你的商户 API 凭证后,可直接发起一笔真实测试订单(最小金额 0.01 元),并在页面内查看返回结果与支付二维码。
1. 登录 商户自助后台
2. 进入「开发者设置 → API 密钥管理」
3. 创建新密钥对,复制 App-Id、Key-Id、Key-Secret 填入下方
注意:Key-Secret 仅显示一次,请妥善保管,不要泄露给他人。
一、填写 API 凭证
商户应用唯一标识,在后台「API 密钥管理」查看
API 公钥 ID,用于服务端识别签名密钥
API 私钥,用于 HMAC-SHA256 签名,仅前端本地计算
二、配置订单参数
最长 128 字符,将展示在支付凭证中
最小 0.01 元,测试建议使用 0.01 元
选择 C 端用户使用的支付方式
1. 所有签名计算均在你的浏览器本地完成,Key-Secret 不会发送到任何服务器
2. 测试订单为真实交易,付款后将按实际金额结算,请使用小额测试
3. 请勿在公共电脑上保存你的 API 凭证,测试完成后关闭页面即可