商户进件支付系统 API 对接开发文档
获取商户秘钥
网站对接,需要先获取到对接 API 账号以及秘钥和网关地址。
登录商户面板-api面板里(审核认证后的账号才有秘钥,没有审核的客户需要提交认证资料联系客服进行审核)
通道 API 管理-通道费率可以获取到相应通道编码
接口参数说明
Post 支付网关地址: https://www.88fk.net/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(随时有变动的可能,请以商户后台显示的为准) |
京东支付 |