汇付托管接口开发文档

5个月前 (19/01/2019) 沙粒网 95

# 汇付托管接口开发文档

## 测试环境

> 接口调用：[http://mertest.chinapnr.com/muser/publicRequests](http://mertest.chinapnr.com/muser/publicRequests)  
> P2P账户查询：[http://mertest.chinapnr.com/p2puser/](http://mertest.chinapnr.com/p2puser/)
> 商户控台：[http://mertest.chinapnr.com/p2padmin/](http://mertest.chinapnr.com/p2padmin/)  
> 开发者站点：[http://www.chinapnr.com/p2pdev/](http://www.chinapnr.com/p2pdev/)

## 生产环境

> 接口调用：[http://lab.chinapnr.com/muser/publicRequests](http://lab.chinapnr.com/muser/publicRequests)  
> P2P账户查询：[https://c.chinapnr.com/p2puser/](https://c.chinapnr.com/p2puser/)
> 商户控台：[http://lab.chinapnr.com/p2padmin/](http://lab.chinapnr.com/p2padmin/)  
> 开发者站点：[http://www.chinapnr.com/p2pdev/](http://www.chinapnr.com/p2pdev/)

## P2P账户查询系统

该系统主要提供用户的资金明细查询、解绑快捷卡、修改电子邮箱等操作。

## 商户控台

汇付提供的商户后台系统，可查询商户的收支记录、平台用户的收支记录。

- 账户管理  
- 交易查询  
- 下载中心  
- 系统设置  
  - 配置**解绑快捷卡通知**接口通知地址
  - 配置移动端(APP、微信)接口的主题颜色  
  - 重发回调信息

## 开发者站点

主要提供最新的接口文档下载、接口答疑、公告等。

# 参数加签、验签

下面提供的加签、验签函数，需要汇付提供的jar支持，该jar可通过[开发者站点](#url)下载

## 获取md5密文

> 新接口，即升级后的3.0接口或者新增的接口，请求参数、回调参数都需要先调用md5对明文加密后，在调用汇付RSA对md5密文进行签名。

```java
SecureLink secureLink = new SecureLink();
String md5 = secureLink.md5Digest(明文.getBytes("UTF-8"));
//省略...
```

## 请求参数加签

根据接口文档中需要加签的字段按照顺序拼接，然后调用汇付提供的加签函数校验。

加签函数

```java
/**
* 签名，按照顺序签名
* @param merId 客户号
* @param merKeyFile 商户私钥文件
* @param planStr 待签名串
* @return 加签后的密文
*/
public static String sign(String merId, String merKeyFile, String planStr){
   SecureLink secureLink = new SecureLink();
   int signMsg = 0;
   try {
   signMsg = secureLink.SignMsg(merId, merKeyFile, planStr.getBytes("UTF-8"));
   } catch (UnsupportedEncodingException e) {
       e.printStackTrace();
       return null;
   }
   if (signMsg != 0) {
       return null;
   }
   return secureLink.getChkValue();
}
```

## 回调参数验签

根据接口文档中需要加签的字段按照顺序拼接，然后调用汇付提供的加签函数校验。

验签函数

```java
/**
* 验证签名
* @param sign 连接串
* @param plain 签名串
* @param pgKeyFile 商户公钥文件
* @return true 通过|false：失败
*/
public static boolean veriSign(String sign, String plain, String pgKeyFile){
   SecureLink secureLink = new SecureLink();
   int flag = secureLink.VeriSignMsg(pgKeyFile, plain, sign);
   return flag == 0;
}
```

## 需md5加密的接口

> 汇付升级后的3.0接口以及新增的接口需要先使用md5对参数进行明文加密后，再使用RSA对md5密文加签，以下为部分接口参照表。

|接口名称|请求参数|回调参数|
|----|----|----|
|4.2.7. 解绑快捷卡通知|----|true|
|4.3.10.自动扣款（还款）|true|true|
|4.3.17.债权转让接口|true|true|
|4.3.18.自动债权转让接口|true|true|
|4.4.20.标的审核状态查询接口|true|true|
|4.4.22.标的投标信息查询接口|true|true|

## 签名原串

> 汇付部分接口，会主动返回签名原串，以`Plain*`开头，验签时可直接使用该字段的值进行验签，免去手动组装签名原串，以下为部分接口参照表。

|接口|key|接口|key|
|----|----|----|----|
|余额查询（后台）|PlainStr|      债权查询接口|PlainStr|
|商户子账户信息查询|PlaintStr|   |生利宝转入对账接口|PlainStr|
|4.4.4. 交易状态查询|PlainStr|         4.4.15.生利宝转出对账接口|无|
|4.4.5. 自动投标计划状态查询|PlainStr|  4.4.16.生利宝产品信息查询|无|
|4.4.6. 放还款对账|PlainText|          4.4.17.生利宝账户信息查询|无|
|4.4.7. 商户扣款对账|PlainText|        4.4.18.用户信息查询|无|
|4.4.8. 取现对账|无|                   4.4.19.交易明细查询|PlainStr|
|4.4.10.充值对账|PlainText|            4.4.20.标的审核状态查询接口|无|
|4.4.11.银行卡查询接口|PlainText|       4.4.21.可取现金额查询（后台）|无|
|4.4.12.企业开户状态查询接口|无|         4.4.22.标的投标信息查询接口|无|

## 测试环境说明

- 快捷绑卡只支持**建行卡**绑定。

- 普通绑卡支持**上海银行|招商银行**绑定。

部分银行的卡bin开头部分

```java
建设银行：621081|621499|621082|621598|621466
农业银行：622822|622825|622821|622823|622841
工商银行：621102|621204|621203|621206|621205
中国银行：620107|621660|621661|621662|621663
中信银行：622690|622691|622692|622696|622698
光大银行：622660|622662|622663|622664|622665
兴业银行：622908
上海银行：622172
招上银行：622580  
```