开发文档

首页/开发文档

开放接口文档

收银台下单、API 下单、订单查询、退款、通知、签名和 WordPress 插件

内容与商户控制台保持同步。所有接口和签名都必须由商户服务端调用，不要在浏览器暴露商户 KEY。

notifyUrl 非必填；未配置回调时，商户必须通过查询订单接口主动确认支付结果。

当前支持：扫码支付、JSAPI 支付和 H5 支付；H5 支付仅个体工商户和企业主体支持。

主网关https://jpay.hzjianban.com

备用网关（支持 IPv6）https://api.jian-pay.com

MD5 签名算法

收银台下单、API 下单、查询接口和支付通知验签都使用同一套 MD5 规则。

签名规则

签名规则
1. 排除 sign、sign_type 和空值字段
2. 字段名按 ASCII 升序排序
3. 拼接格式：key=value&key=value
4. 参数值不做 URL 编码
5. object 类型先转 JSON 字符串再参与签名
6. 商户 KEY 不参与排序，在拼好的字符串末尾直接拼接
7. 对完整字符串做 MD5，并转成小写

示例待签名参数（为便于阅读按行展示，实际签名时不要加入换行）
amount=100
clientNo=JP26070612345678
goodsName=测试商品
notifyUrl=https://example.com/pay/notify
orderNo=P202607080001
param=user_id=1001
payMethod=wx
returnUrl=https://example.com/pay/result
timestamp=1783500000

完整签名原串（实际拼接为一行）
amount=100
&clientNo=JP26070612345678
&goodsName=测试商品
&notifyUrl=https://example.com/pay/notify
&orderNo=P202607080001
&param=user_id=1001
&payMethod=wx
&returnUrl=https://example.com/pay/result
&timestamp=1783500000
商户KEY

最终签名
sign = md5(待签名串 + 商户 KEY).toLowerCase()