商户进件支付系统 API 对接开发文档

2019-11-20 火光科技

商户进件支付系统 API 对接开发文档

 
获取商户秘钥
 
网站对接,需要先获取到对接 API 账号以及秘钥和网关地址。
 
登录商户面板-api面板里(审核认证后的账号才有秘钥,没有审核的客户需要提交认证资料联系客服进行审核)
通道 API 管理-通道费率可以获取到相应通道编码

接口参数说明
 
Post 支付网关地址: https://wwv.jxkej.cn//pay/api
 
注意,提交方式是POST,请不要用GET方式提交

参数名称 参数含义 是否必填 参与签名 参数说明
userid 商户号 平台分配商户号
orderno 订单号 上送订单号唯一, 字符长度 20
title 商品名称  
paycode 通道编码 通道编码请以商户后台显示的为准
notify_url 异步支付回调地址 处理成功支付业务逻辑
return_url 支付成功支付回调地址 只是通知显示,不处理业务逻辑
amount 订单金额 商品金额
sign MD5 签名 请看 MD5 签名字段格式


签名算法:
 
签名生成的通用步骤如下:
 
第一步,设所有参与签名的数据为集合 M,将集合 M 内的参数按照参数名 ASCII 码从小到大排序(字典序),使用 URL 键值对的格式(即key1=value1&key2=value2…)拼接成字符串stringA。
 
第二步,在 stringA 最后拼接上 key 得到 stringSignTemp 字符串,并对 stringSignTemp 进行 MD5 运算,得到 sign 值 signValue。   php举例: $sign=md5(stringA.$key);
支付结果通知:
 
参数名称 参数含义 参与签名 参数说明
amount 订单金额  
orderno 订单号 上送订单号唯一, 字符长度 20
title 商品名称  
transaction 交易流水号  
notify_url 异步支付回调地址 处理成功支付业务逻辑
return_url 支付成功支付回调地址 只是通知显示,不处理业务逻辑
errcode 交易状态

“0” 为成功
“1” 为失败
“errmsg” 同时返回具体错误信息

sign 签名 请看验证签名字段格式
注:返回参数没有userid,但签名字段包含userid。如果接收到服务器点对点通讯时,在页面输出“ok”(没有双引号,ok 两个字母小写),否则会重复 3 次发送点对点通知.
 
[附件]银行编码参考
 
通道编码 银行名称
001(随时有变动的可能,请以商户后台显示的为准) 支付宝电脑版
002(随时有变动的可能,请以商户后台显示的为准) 支付宝手机版
003(随时有变动的可能,请以商户后台显示的为准) 微信扫码
004(随时有变动的可能,请以商户后台显示的为准) 微信H5
005(随时有变动的可能,请以商户后台显示的为准) 微信公众支付
006(随时有变动的可能,请以商户后台显示的为准) QQ钱包
007(随时有变动的可能,请以商户后台显示的为准) 京东支付