01 对接流程

1. 1

   登录商户后台

   1.进入 会员信息 → 绑定谷歌验证

   2.进入 支付通道 → 开发设置

2. 2

   获取 MD5 秘钥

   在开发设置页面查看并复制您的专属 MD5 秘钥

3. 3

   生成 RSA 密钥对

   ==>秘钥工具下载<==

   使用支付宝 RSA 秘钥工具生成 PKCS8 (2048位) 密钥对

   • 私钥请自行安全保存
   • 公钥上传至商户后台

4. 4

   开始接口对接

   参考下方接口列表进行开发

02 接口规范

请求方式

HTTP POST

响应方式

HTTP JSON

接口签名

1. 将接口中的请求字段按照 ASCII 码升序 排序
2. 按照 key1=val1&key2=val2&...&key=md5秘钥 生成加密字符串
3. 将上一步生成的字符串进行 MD5 加密，并转换成 大写
4. 使用您的 私钥 对第 3 步生成的密文进行 RSA 签名

回调验签

1. 将回调中的字段按照 ASCII 码升序 排序
2. 按照 key1=val1&key2=val2&...&key=md5秘钥 生成加密字符串
3. 将上一步生成的字符串进行 MD5 加密，并转换成 大写
4. 使用平台 公钥 对第 3 步生成的密文进行验签

01

交易接口

请求地址：api地址/pay

请求字段

字段名	字段描述	是否必需	说明事项
merId	商户号	是
orderId	订单号	是
orderAmt	交易金额	是	单位：元
channel	通道类型	是	请查看商户后台支付通道→通道列表
desc	订单描述	是
attch	附加信息	否	通知会返回该字符串
smstyle	扫码模式	否	如无特殊情况请传1
userId	用户编号	快捷模式下必传
ip	下单ip地址	是
notifyUrl	通知地址	是
returnUrl	页面跳转地址	是
nonceStr	随机字符串	是	最长32位
sign	签名	是

响应字段

字段名	字段描述
payurl	支付页面地址，跳转即可
orderno	商户单号
sysorderno	我方系统单号

02

通知接口

字段名	字段描述
merId	商户号
orderId	商户单号
sysOrderId	我方系统单号
desc	系统描述
orderAmt	订单金额
status	订单状态：1为支付成功
nonceStr	随机字符串
sign	验签字段
attch	附加信息

03

交易查询接口

请求地址：api地址/pay/query

字段名	字段描述	是否必需	说明事项
merId	商户号	是
orderId	订单号	是
nonceStr	随机字符串	是	最长32位
sign	签名	是

响应字段

merId	商户号
status	订单状态 0：未支付 1：支付成功
orderId	商户订单号
sysOrderId	我方订单号
orderAmt	订单金额
nonceStr	随机字符串
sign	签名

04

代付接口

请求地址：api地址/pay/repay

字段名	字段描述	是否必需	说明事项
merId	商户号	是
orderId	订单号	是
money	代付金额	是	单位：元
name	姓名	是
ka	银行卡号	是
bank	银行	是
province	省份	否
city	城市	否
zhihang	支行	否
notifyUrl	通知地址	否
returnUrl	页面跳转地址	是
nonceStr	随机字符串	是	最长32位
sign	签名	是

响应字段

merId — 商户号

orderId — 代付订单号

nonceStr — 随机字符串

sign — 签名

05

代付查询接口

请求地址：api地址/pay/repayquery

字段名	字段描述	是否必需	说明事项
merId	商户号	是
orderId	代付订单号	是
nonceStr	随机字符串	是	最长32位
sign	签名	是

字段名	字段描述
merId	商户号
status	代付订单状态: 0=申请中,1=已支付,2=冻结,3=取消
orderId	代付订单号
money	代付金额
nonceStr	随机字符串
sign	签名

06

代付回调接口

字段名	字段描述
merId	商户号
orderId	代付单号
money	代付订单金额
status	代付订单状态:0=申请中,1=已支付,2=冻结,3=取消
nonceStr	随机字符串
sign	验签字段
attch	附加信息