互联网金融平台动态监管系统接口规例文档

发布时间:2020-10-17 10:15:34 来源: 应用文书 点击:

互联网金融-监管系统接口规范V1.0

互联网金融平台动态监管系统

数据上报接口文档

(v1.0)

天津XX信息技术有限公司

目录

TOC \o "1-3" \h \z \u 1、接口 3

1.1概述 3

1.2接入说明 3

1.2.1接入准备(接入申请) 3

1.2.2接口规范 4

1.2.3数据加密 5

2、接口列表 7

2.1合同业务接口参数列表 7

2.2还款业务接口参数列表 9

2.3资金对账业务接口参数列表 (针对第三方支付公司获取) 10

3、附录 11

附录1 交易类型约定 11

附录2 返回状态码列表 11

附录3贷款投向(国标) 11

1、接口

1.1概述

本文档主要采用从两个接口层面来实现对互联网金融平台的监管,一方面从受监管互联网金融平台推送获得数据,一方面从第三方支付平台或银行获取数据,通过两边的数据再进行比对,最终确保互联网金融平台信息数据和资金交易数据的有效监管。接口主要分有两部分,一部分是针对受监管的互联网金融平台数据端请求接口的说明。一部分是针对从第三方支付公司获取数据接口的说明。

阅读对象:技术开发人员。

1.2接入说明

1.2.1接入准备(接入申请)

在监管系统注册,申请审核通过后,在【用户后台->我的接口】中查看平台ID,通信密钥并填写我的访问IP,方能在该IP的服务器中访问接口获取接口数据。

注:非允许IP的服务器访问改接口无效。

平台接入流程如下(具体以监管平台为准):

1.2.2接口规范

协议:接口采用HTTP协议访问,必须对传输数据进行加密,校验。

访问方式:接口统一使用post方式,进行访问提交,GET提交数据无效

所有接口都将返回标准的返回参数。如果访问空白,则为网络错误。

接口参数涉及的中文全部使用UTF-8方式编码。

接口参数格式:(其中,具体接口内容及数据都加密与接入的DATA字段中,返回数据未加密)

接入参数

参数

参数名称

类型

是否可空

参数说明

ORGAN_CODE

平台接入ID

INT(5)

非空

在监管平台用户成功接入后获取

DATA

业务参数加密内容

TEXT

非空

业务参数按字母顺序升序排序转json,用AES/ECB/PKCS5Padding加密

SIGN

接口数据签名

VARCHAR(32)

非空

Data数据,json前后加appId做MD5作为签名数据sign

返回参数:

参数

参数名称

类型

是否可空

参数说明

CEDE

状态

INT(5)

非空

业务状态,状态代码详见附录,或者具体接口说明

DATA

返回数据

TEXT

非空

Json格式数据,如果无数据,则返回空数组

MSG

接口信息

VARCHAR(200)

非空

接口状态信息

注:返回CODE:详见附录2

1.2.3数据加密

加密的数据为接口中的DATA部分,只加密提交的部分。

加密数据采用AES/ECB/PKCS5Padding方式进行加密,具体加密过程如下

JAVA:

public static String encrypt(String input, String key){

byte[] crypted = null;

try{

SecretKeySpec skey = new SecretKeySpec(key.getBytes(), "AES");

Cipher cipher = Cipher.getInstance("AES/ECB/PKCS5Padding");

cipher.init(Cipher.ENCRYPT_MODE, skey);

crypted = cipher.doFinal(input.getBytes());

}catch(Exception e){

System.out.println(e.toString());

}

return new String(Base64.encodeBase64(crypted));

}

PHP:

public static function encrypt($input, $key) {

$size = mcrypt_get_block_size(MCRYPT_RIJNDAEL_128, MCRYPT_MODE_ECB);

$input = self::pkcs5_pad($input, $size);

$td = mcrypt_module_open(MCRYPT_RIJNDAEL_128, '', MCRYPT_MODE_ECB, '');

$iv = mcrypt_create_iv (mcrypt_enc_get_iv_size($td), MCRYPT_RAND);

mcrypt_generic_init($td, $key, $iv);

$data = mcrypt_generic($td, $input);

mcrypt_generic_deinit($td);

mcrypt_module_close($td);

$data = base64_encode($data);

return $data;

}

数据签名为MD5,前后连接校验码的JSON格式的DATA数据,再转化成小写,格式为:

md5(SIGNKEY+DATA+ SIGNKEY)

2、接口列表

注:每家平台只有一家支付公司,在平台注册时,提交支付公司信息

接口接入场景:

互联网金融平台交易成功,即合同生成时同步实时报送合同信息;

监管系统接收到信息后,进入监管系统进行备案,备案后会返回已备案结果(备案单号);

还款实时上报;

其他交易信息实时上报;

从第三方支付公司获取资金交易数根据订单与互联网金融平台数据进行配对,核实无误,进入备案。

2.1合同业务接口参数列表

接口地址

测试接口地址:http://***/api/project

正式接口地址:http://***/api/project

提交参数

字段ID

中文含义

类型/长度

是否可空

备 注

输入/输出参数

TRANS_CODE

交易类型

VARCHAR(6)

非空

参考附录1

输入

LOAN_SERIALNO

借款合同编号

VARCHAR(50)

非空

PAWN_TYPE

抵押物类型

INT

0房产,1汽车,2,其他

PAWN_NO

抵押物编号

VARCHAR(50)

LOAN_NO

贷款订单号

VARCHAR(50)

非空

输入

LOAN_NAME

贷款名称

VARCHAR(250)

非空

LOAN_MONEY

贷款金额

DECIMAL(16,2)

非空

输入

CUST_NAME

贷款人名称

VARCHAR(100)

非空

个人或公司

输入

CUST_PAPERTYPE

贷款人证件类型

INT

非空

0-身份证,1-营业执照

输入

CUST_PAPERNO

贷款人证件号码

VARCHAR(60)

非空

个人贷款时使用

结婚证、户口本

输入

ASSURE_TYPE

担保方式

VARCHAR(6)

非空

112601 信用

112602 保证

112603 质押

112604 抵押

112605 联保

输入

ASSURE_MEN

担保人明细

NVARCHAR(2000)

非空

输入

LOAN_RATE

贷款利率

VARCHAR(10)

非空

存放月利率

输入

PURPOSE_TYPE

贷款用途

VARCHAR(32)

非空

输入

START_DATE

贷款起息日期

INT

非空

YYYYMMDD

输入

END_DATE

贷款到期日期

INT

非空

YYYYMMDD

输入

INTERESTS_TYPE

计息方式

INT

非空

1-按月计息,

3-按季计息,

5-等额还款,

6-等本还款,

7-等本等息,

12-按年计息,

99-利随本清

13-先息后本(按月、按天)

LOAN_SPAN

贷款期限

INT

非空

以”天”、“月”为单位存储, 0天,1月

输入

CUST_HY

贷款人所属行业

INT

非空

0-农林牧渔业贷款、1-工业贷款、2-服务业贷款、3-其他

输入

LOAN_STATE

贷款状态

INT

非空

0-正常,

1-逾期1个月以内,

2-逾期1个月-3个月,

3-逾期3个月-6个月,

4-逾期6个月-1年,

5-逾期1年以上,

6-结清,7-撤销

8-展期

9-坏账

10-提起还款

输入

PAY_MODE

还款方式

INT

非空

一次性还款,1-分期还款

输入

CREDIT_PURPOSE

贷款投向

VARCHAR(30)

非空

详见附录2

输入

DKTF_ADDRESS

贷款投放地

VARCHAR(12)

非空

1147XX

输入

JKYT_INFO

借款用途

NVARCHAR(200)

非空

输入

INVESTOR_NO

投资订单号

VARCHAR(50)

非空

输入

INVESTOR_NAME

投资人名称

VARCHAR(20)

非空

个人或公司

输入

INVESTOR_PAPERTYPE

投资人证件类型

INT

非空

0-身份证,1-营业执照

INVESTOR_PAPERNO

投资人证件号码

VARCHAR(18)

非空

输入

INVESTOR_MONEY

投资金额

DECIMAL(16,2)

非空

输入

INVESTOR_TIME

投资时间

INT

非空

YYYYMMDD

输入

RECORD_NO

备案流水号

VARCHAR(50)

非空

输出

返回参数

字段ID

中文含义

类型/长度

是否可空

参数说明

RECORD_NO

备案流水号

VARCHAR (50)

非空

2.2还款业务接口参数列表

接口地址

测试接口地址:http://***/api/repay

正式接口地址:http://***/api/repay

提交参数

字段ID

中文含义

类型/长度

是否可空

备 注

输入/输出参数

TRANS_CODE

交易类型

VARCHAR(6)

非空

参考附录1

输入

CONTRACT_BH

贷款订单号

VARCHAR(18)

非空

输入

REPAY_NO

还款订单号

INT

非空

输入

FUND_BUSI_FLAG

还款类别

VARCHAR(10)

非空

1:正常

2:提前

3:逾期

4.展期

输入

REPAY_MONEY

还款金额

DECIMAL(16,2)

非空

输入

REPAY_PERIOD

还款期数

INT

非空

REPAY_DATE

还款日期

INT

非空

YYYYMMDD

输入

REPAY_TIME_YES

实际还款日期

INT

YYYYMMDD

对应逾期、提前、展期

LEFT_MONEY

剩余款项

DECIMAL(16,2)

非空

输入

RECOVER_NAME

收款人

VARCHAR(20)

非空

RECOVER_AMOUNT

收款金额

DECIMAL(16,2)

非空

返回参数

字段ID

中文含义

类型/长度

是否可空

参数说明

RECORD_NO

备案流水号

VARCHAR (50)

非空

2.3资金对账业务接口参数列表 (针对第三方支付公司获取)

注:此接口暂时做采集数据参考使用(用于产品设计前后台内容)

提交参数

字段ID

中文含义

类型/长度

是否可空

备 注

输入/输出参数

ORGAN_CODE

平台接入ID

VARCHAR(10)

非空

参考附录1

输入

TRANS_CODE

交易类型

VARCHAR(6)

非空

输入

TRANS_TIME

交易时间

INT(10)

非空

YYYYMMDD

输入

TRANS_NO

交易流水号

VARCHAR(50)

非空

输入

ORGAN_TRANS_NO

平台订单号

VARCHAR(50)

非空

输入

TRANS_MONEY

交易金额

DECIMAL(16,2)

非空

输入

PAY_NAME

付款方姓名

VARCHAR(20)

非空

个人或公司

输入

PAY_PAPERTYPE

付款方证件类型

INT

非空

0-身份证,1-营业执照

输入

PAY_PAPERNO

付款方身份证号

VARCHAR(18)

非空

输入

RECEIVE_PAPERTYPE

收款方证件类型

INT

非空

0-身份证,1-营业执照

输入

RECEIVE_NAME

收款方

VARCHAR(20)

非空

个人或公司

输入

RECEIVE_PAPERNO

收款方身份证号

VARCHAR(18)

非空

输入

3、附录

附录1 交易类型约定

合同类:01

0001 贷款信息登记

0002 债权转让登记

0003 存款类交易登记

0004 贷款归还信息登记

0005 其他交易类登记

附录2 返回状态码列表

10000:成功

10001:失败

附录3贷款投向(国标)

112201 1A-农、林、牧、渔业农业林业畜牧业渔业农、林、牧、渔服务业

112202 2B-采矿业

112203 2C-制造业农副食品加工食品制造饮料制造烟草制品纺织业纺织服装、鞋、帽制造皮革、毛皮、羽毛(绒)及其制品木材加工及木、竹、藤、棕、草制品家具制造造纸及纸制品印刷业和记录媒介的复制文教体育用品制造石油加工、炼焦及核燃料加工化学原料及化学制品制造医药制造化学纤维制造橡胶制品塑料制品非金属矿物制品黑色金属冶炼及压延加工有色金属冶炼及压延加工金属制品通用设备制造专用设备制造交通运输设备制造电气机械及器材制造通信设备、计算机及其他电子设备制造仪器仪表及文化、办公用机械制造工艺品及其他制造废弃资源和废旧材料回收加工

112204 2D-电力、燃气及水的生产和供应业

112205 2E-建筑业

112206 3F-交通运输、仓储和邮政业

112207 3G-信息传输、计算机服务和软件业

112208 3H-批发和零售业

112209 3I-住宿和餐饮业

112210 3J-金融业

112211 3K-房地产业

112212 3L-租赁和商务服务行业

112213 3M-科学研究、技术服务和地质勘查业

112214 3N-水利、环境和公共设施管理业

112215 3O-居民服务和其他服务业

112216 3P-教育

112217 3Q-卫生、社会保障和社会福利业

112218 3R-文化、体育和娱乐业

112219 3S-公共管理和社会组织

112220 3T-国际组织

112221 3Z-其他行业

相关热词搜索:监管 规例 互联网 监管 互联网金融平台动态监管系统接口规例文档

版权所有 静静文本网 www.lxzcp.com