本文阅读对象:使用 豹支付 商户自服务系统的技术架构师、研发工程师、系统运维工程师。通过本文档,商户可了解 豹支付 接入的技术、接入的产品业务、接入的流程、接入规范等信息,以便于商户顺利完成接入工作。
接入网关
请登录商户中心,API管理 开发文档中 查看网关地址和API对接参数。
统一下单接口
提交方式:POST
地址: 接入网关/Pay_Index.html
参数名称参数含义是否必填参与签名参数说明
pay_memberid商户号平台分配商户号
pay_orderid订单号上送订单号唯一, 字符长度20
pay_applydate提交时间时间格式:2016-12-26 18:18:18
pay_bankcode银行编码在商户中心查询
pay_notifyurl服务端通知服务端返回地址.(POST返回数据)
pay_callbackurl页面跳转通知页面跳转返回地址(POST返回数据)
pay_amount订单金额单位:元
pay_md5signMD5签名请查看签名算法
pay_productname商品名称
pay_productnum商户品数量
pay_productdesc商品描述
pay_producturl商户链接地址
异步通知
提交方式:POST
接收到服务器点对点通讯时,在页面输出“OK”( 没有双引号,OK 两个字母大写 ) ,否则会重复5次发送点对点通知.
参数名称参数含义是否必填参与签名参数说明
memberid商户编号平台分配商户号
orderid订单号上送订单号唯一, 字符长度20
amount订单金额
transaction_id交易流水号
datetime交易时间
returncode交易状态00表示成功,其它表示失败
attach扩展返回商户附加数据返回
signMD5签名
订单查询接口
提交方式:POST
地址: 接入网关/Pay_Trade_query.html
参数名称参数含义是否必填参与签名参数说明
pay_memberid商户编号
pay_orderid商户订单号
pay_md5signMD5签名
返回值
参数名称参数含义是否必填参与签名参数说明
memberid商户编号
returncode请求状态00表示成功,其它表示失败
data订单信息(数据类型:集合)
signMD5签名
返回值data参数
参数名称参数含义参数说明
orderid商户订单号
transaction_id平台订单号
amount订单金额单位:元
time_end支付成功时间
trade_state支付状态SUCCESS:支付成功,NOTPAY:未支付
代付提交接口
提交方式:POST
提交地址:网关地址+/Payment_Dfpay_add.html
参数名称参数含义是否必填参与签名参数说明
mchid商户编号平台分配商户号
out_trade_no商户订单号保证唯一值
money订单金额单位:元
bankname开户行名称
subbranch支行名称
accountname开户名
cardnumber银行卡号
province省份
city城市
extends附加字段
signMD5签名
注:extends字段具体需要上送哪些字段以及字段的含义,对接时请咨询平台方,如果不需要扩展字段则不传。不为空时,格式:先转化为JSON,接着进行Base64加密
例如:扩展字段为phone和idno,extends[phone]=13800138000,extends[idno]=111111111111111111。首先将extends转化为JSON格式得到{"phone":"13800138000","idno":"111111111111111111"},然后将此JSON字符串进行base64加密得到eyJwaG9uZSI6IjEzODAwMTM4MDAwIiwiaWRubyI6IjExMTExMTExMTExMTExMTExMSJ9,最终得到extends=eyJwaG9uZSI6IjEzODAwMTM4MDAwIiwiaWRubyI6IjExMTExMTExMTExMTExMTExMSJ9。
返回值
参数名称参数含义是否必填参与签名参数说明
status状态成功:success 失败:error(不代表业务成功)
msg状态描述
transaction_id平台流水号成功时返回
代付查询接口
提交方式:POST
提交地址:网关地址+/Payment_Dfpay_query.html
参数名称参数含义是否必填参与签名参数说明
out_trade_no商户订单号
mchid商户号
pay_md5sign签名
返回值
参数名称参数含义是否必填参与签名参数说明
status状态success:请求成功(不代表业务成功),error:请求失败
msg状态描述
mchid商户号status=success时返回
out_trade_no商户订单号status=success时返回
amount金额status=success时返回
transaction_id平台流水号status=success时返回
refCode业务状态status=success时返回
refMsg业务描述status=success时返回
success_time成功时间status=success,refCode=1时返回
signMD5签名
refCode返回值
返回值含义
1成功
2失败
3处理中
4待处理
5审核驳回
6待审核
7交易不存在
8未知状态
注:当status=success和refCode=1同时成立时才表示转账成功
签名算法
签名生成的通用步骤如下:
第一步,设所有发送或者接收到的数据为集合M,将集合M内非空参数值的参数按照参数名ASCII码从小到大排序(字典序),使用URL键值对的格式(即key1=value1&key2=value2…)拼接成字符串。
第二步,在stringA最后拼接上应用key得到stringSignTemp字符串,并对stringSignTemp进行MD5运算,再将得到的字符串所有字符转换为大写,得到sign值signValue。
stringSignTemp="pay_amount=pay_amount&pay_applydate=pay_applydate&pay_bankcode=pay_bankcode&pay_callbackurl=pay_callbackurl&pay_memberid=pay_memberid&pay_notifyurl=pay_notifyurl&pay_orderid=pay_orderid&key=key" sign=MD5(stringSignTemp).toUpperCase()
账户余额查询接口
提交方式:POST
接口地址:网关地址+/Payment_Dfpay_balance.html
参数名称参数含义是否必填参与签名参数说明
mchid商户编号平台分配商户号
pay_md5signMD5签名
返回值
参数名称参数含义是否必填参与签名参数说明
status状态success:请求成功,error:请求失败
msg状态描述
mchid商户号status=success时返回
balance可提现余额status=success时返回
blockedbalance冻结余额status=success时返回
pay_md5signMD5签名
渠道编码
请登录商户中心,API管理 通道费率中 查看所属应用的支付通道编码。


首页
产品
新闻
联系