PPayHub开发者文档
获取 API 密钥 开始接入

PayHub 聚合支付 API

一套接口接入微信支付、支付宝、银联等主流支付渠道,支持扫码支付、收银台跳转、异步回调与退款对账。

产品介绍

PayHub 是面向电商、SaaS 与线下门店的聚合支付接入平台。开发者只需对接一套 RESTful API,即可同时支持微信扫码、支付宝扫码、银联等多种支付方式,无需分别对接各渠道。

所有接口均通过 HTTPS 调用,请求与响应均为 JSON 格式。基础地址:https://www.dkzhushou.cn

快速开始

1. 注册商户账号

前往 商户后台 注册并完成企业认证,在「开发者设置」中获取 App-Id 与 Key-Secret。

2. 构造请求

每个请求需在 HTTP Header 中携带以下字段:

Header说明示例
App-Id商户应用 IDAPP31CBD54C560A0D59
Key-IdAPI 密钥 IDak_1be70dbea4c44d5d
Timestamp当前 Unix 时间戳(秒)1731672000
Nonce随机字符串,防重放a1b2c3d4e5f6
SignHMAC-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');
时间戳与服务器误差不能超过 5 分钟,Nonce 5 分钟内不可重复使用,否则请求将被拒绝。

POST 创建支付订单

/openapi/v1/pay/create

创建一笔支付订单,返回收银台链接或渠道支付码。

请求参数

字段类型必填说明
subjectstring是订单标题,最长 128 字
amountnumber是金额(元),最小 0.01
channelstring是渠道:wxpay_native / alipay_qr
out_trade_nostring是商户系统唯一订单号
notify_urlstring否支付结果异步回调地址
return_urlstring否支付完成前端跳转地址

请求示例

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

主动查询订单状态。建议在接收异步回调失败时,用此接口主动查询补单。

字段说明
orderNoPayHub 订单号(创建接口返回)

POST 申请退款

/openapi/v1/refund/create

对已支付订单发起退款,支持部分退款。

字段类型必填说明
order_nostring是PayHub 订单号
refund_amountnumber是退款金额(元)
reasonstring否退款原因

异步回调通知

支付成功后,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 元),并在页面内查看返回结果与支付二维码。

如何获取 API 凭证?
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 凭证,测试完成后关闭页面即可