协议规则

请求格式 application/x-www-form-urlencoded 返回格式 JSON 签名算法 MD5 字符编码 UTF-8

页面跳转支付

适用于前台直接发起支付,支持 form 表单或 URL 跳转。

字段名变量名必填类型示例值描述
商户IDpidInt1001平台分配商户号
支付方式typeStringalipay支付方式列表
商户订单号out_trade_noString20160806151343349唯一
异步通知地址notify_urlStringhttp://www.pay.com/notify.php服务器异步通知
跳转通知地址return_urlStringhttp://www.pay.com/return.php同步跳转
商品名称nameStringVIP会员超过127字节自动截取
商品金额moneyString1.00单位元,最多两位小数
业务扩展参数paramString自定义参数支付后原样返回
签名字符串signString202cb962ac59075b964b07152d234b70签名算法
签名类型sign_typeStringMD5默认MD5

请求地址: https://pay.pr06.cn/submit.php (POST/GET)

提示:不传递 type 参数时会跳转至收银台,用户自主选择支付方式。

API接口支付

后端发起支付,返回二维码链接 / 支付跳转URL / 小程序scheme。

字段名变量名必填类型示例值描述
商户IDpidInt1001-
支付方式typeStringwxpay支付方式列表
商户订单号out_trade_noString202408211234唯一订单号
异步通知地址notify_urlStringhttp://domain/notify.php异步回调
跳转通知地址return_urlStringhttp://domain/return.php同步跳转
商品名称nameString月度会员-
商品金额moneyString19.99精确到分
用户IP地址clientipString192.168.1.100客户端真实IP
设备类型deviceStringwechat设备类型列表
扩展参数paramStringorder123原样返回
签名字符串signStringmd5值参照签名规则
签名类型sign_typeStringMD5-

API地址: https://pay.pr06.cn/mapi.php (POST)

返回JSON示例:

{
  "code": 1,
  "msg": "success",
  "trade_no": "202408211234567",
  "payurl": "https://pay.domain/pay/xxx",
  "qrcode": "weixin://wxpay/bizpayurl?pr=xxx",
  "urlscheme": "weixin://dl/business/?t=xxx"
}
其中 payurlqrcodeurlscheme 仅返回其一,根据支付场景适配。

支付结果通知

服务器异步通知 notify_url 与 页面跳转通知 return_url 均通过 GET 方式回调以下参数。

字段名变量名说明
商户IDpid平台商户号
易支付订单号trade_no系统订单号
商户订单号out_trade_no原始商户订单号
支付方式typealipay / wxpay / unionpay
商品名称name商品标题
商品金额money实际支付金额
支付状态trade_statusTRADE_SUCCESS 代表成功
扩展参数param原样透传
签名signMD5签名
签名类型sign_typeMD5
异步通知收到后请务必返回字符串 success(不加任何HTML及空格),否则系统会重发通知。

MD5签名算法

1. 将所有请求参数(signsign_type 以及空值不参与)按照参数名 ASCII 升序排序。
2. 排序后拼接为 url 键值对格式:key1=value1&key2=value2(不转义特殊字符)。
3. 拼接商户密钥 KEY 得到待签名字符串:待签名字符串 + KEY
4. 对上述字符串进行 MD5 哈希,得到 32 位小写签名字符串。

示例:
参数: pid=1001&money=1.00&name=会员&out_trade_no=202501011234
商户KEY = 5hG7Lk2d9F1sX
待签名字符串 = "money=1.00&name=会员&out_trade_no=202501011234&pid=1001" + "5hG7Lk2d9F1sX"
sign = md5(待签名字符串) -> 32位小写

开发建议:参考官方 SDK 或各语言示例代码实现。

支付方式列表

调用值描述
alipay支付宝支付
wxpay微信支付
unionpay云闪付

设备类型列表

调用值描述
pc电脑浏览器
mobile手机浏览器
qq手机QQ内建浏览器
wechat微信内浏览器
alipay支付宝客户端

pr06a61y pay · 开发文档 · 聚合支付接口规范