开发文档

首页/开发文档

开放接口文档

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

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

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

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

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

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

支付通知回调

配置 notifyUrl 后，平台会向你的服务端发送支付通知；不配置则不会回调，需要主动查单。

字段	说明
clientNo	商户号。
orderId	简付平台订单号。
merchantOrderNo	商户下单时传入的 orderNo。
amount	订单金额，单位分。
status	订单状态：0-待发起，1-处理中，2-支付成功，3-支付失败，4-已关闭。
goodsName	商品名称。
payMethod	支付方式。
payType	支付类型。
param	商户下单时传入的附加参数。
paidAt	支付完成时间，格式 YYYY-MM-DD HH:mm:ss。
sign	通知签名，商户必须验签。
sign_type	固定为 MD5。

通知示例

{
  "clientNo": "JP26070612345678",
  "orderId": "PAY202607080001000001",
  "merchantOrderNo": "P202607080001",
  "amount": 100,
  "status": 2,
  "goodsName": "测试商品",
  "payMethod": "wx",
  "payType": "jsapi",
  "param": "user_id=1001",
  "paidAt": "2026-07-08 12:30:00",
  "sign_type": "MD5",
  "sign": "md5签名"
}

通知处理要求

收到通知后返回纯字符串 success，不要返回 JSON，也不要带额外空格。
平台可能重复发送通知，必须按 orderId 或商户订单号做幂等。
处理通知前先验签，再校验金额、商户号和商户订单号。
如果订单已经处理过，直接返回 success，不要重复发货或重复记账。
未配置 notifyUrl，或回调暂未到达时，主动调用查询订单接口补偿。