银行P2P资金存管业务数据文件接口方案培训资料.docx

《银行P2P资金存管业务数据文件接口方案培训资料.docx》由会员分享，可在线阅读，更多相关《银行P2P资金存管业务数据文件接口方案培训资料.docx（36页珍藏版）》请在三一办公上搜索。

1、众邦银行P2P资金存管业务接口方案V1.00_1.06众邦银行中间服务组版本修改记录：版本号完成日期修改人变更描述1.002017-5-14孙曼1、 初稿1.012017-05-17石伟接口文档整体修改1.022017-05-22石伟1、添加签名、验签方式2、充值、提现、转账增加通知地址1.042017-05-22石伟接口整体变更1.052017-05-24石伟转账的“操作标识”字段修改为“转账业务类型”1.062017-05-25石伟1、 增加接口名称，参见接口列表2、 修改 短信验证码获取、短信验证码验证接口，增加订单号。32 第 页 共36页目 录第1章 通讯模式说明11.1 系统参与方

2、11.2 数据传输通讯方式11.2.1. 实时报文传输11.2.2. 文件传输11.3 其他说明21.3.1. 金额单位说明21.3.2. 日期和时间格式说明31.3.3. 接口报文结构31.3.4. 签名串说明31.3.5. 签名算法3第2章 接口说明52.1 接口列表52.2 实时接口说明52.2.1. 短信验证码62.2.1.1. 短信验证码获取62.2.1.2. 短信验证码验证62.2.2. 账户（个人账户）72.2.2.1. 注册72.2.2.2. 账户查询82.2.3. 账户（企业账户）92.2.3.1. 注册92.2.3.2. 账户查询102.2.4. 借贷合同112.2.4.1

3、. 借贷合同同步112.2.4.2. 借贷合同查询122.2.5. 债权转让合同132.2.5.1. 债权转让合同同步132.2.5.2. 债权转让合同查询142.2.6. 充值152.2.6.1. 充值152.2.6.2. 充值查询162.2.7. 交易转账172.2.7.1. 转账172.2.7.2. 转账查询182.2.8. 提现192.2.8.1. 提现192.2.8.2. 提现查询202.2.9. 风险金补偿202.2.9.1. 风现金补偿212.2.9.2. 风现金补偿查询212.2.10. 违约还款222.2.10.1. 违约还款222.2.10.2. 违约还款查询232.2.1

4、1. 销户接口242.2.11.1. 销户接口242.3 日终文件说明252.3.1. 客户资金账户余额对账文件252.3.2. 充值流水对账文件252.3.3. 提现流水对账文件252.3.4. 转账交易对账文件262.3.5. 风险金补偿对账文件262.3.6. 违约还款对账文件27第3章 数据字典283.1 证件类型编码283.2 银行编码283.3 P2P公司商户编码293.4 响应码编码293.5 交易状态编码303.6 账户状态编码303.7 三方支付机构编码303.8 转账业务类型字典30第4章 加解密安全方案说明324.1 国密算法使用说明32第5章 示例报文33第1章 通讯模

5、式说明1.1 系统参与方1、众邦银行：存管银行，以下简称存管行。2、平台：如投哪网，以下简称平台。3、客户：P2P 平台的客户，包括个人客户（借款人、投资人）、企业客户（借款人、投资人、参与方）。1.2 数据传输通讯方式平台与存管行采用HTTP请求（POST方式）进行连接，同时进行RSA签名验证。数据交互分为实时传输和文件传输两种方式。1.2.1. 实时报文传输1、 实时报文传输对应的交易详见接口列表。2、 采用http的方式。3、 报文格式为json格式报文。4、 由公共报文头和报文体拼装而成。5、 编码：UTF-8。6、 接口版本号：1.001.2.2. 文件传输1、 文件传输对应的交易详

6、见接口列表。2、 传输方式：采用socket+SFTP文件传输。由各家平台部署各自的FTP服务器，存管行与平台使用该FTP服务器进行文件交互。3、 文件路径：每日的文件存放在yyyy/mm/dd路径下，例如2017年1月1日的文件存放在该路径下：2017/01/01。4、 加密：采用国密算法加密传输，详见以下“加解密安全方案说明”。5、 编码：UTF-8。6、 压缩：文件采用gzip进行压缩。7、 文件内容约定： 文件第一行内容：标志（0表示文件正常，默认填0）&;信息提示（即文件释义，例如：销户文件）&;总笔数。 文件第二行内容：字段中文名，字段之间以&;隔开。 文件每行一条记录（以rn作为

7、换行符），每天记录包含多个字段，每个字段以“&;”隔开。 每个字段的内容不允许有换行符和&;,如果存在，直接去除非法字符 文件内容为文本，含英文、数字字符，含中文字符，中文字符建议不超出UTF-8编码范围。8、 汇总校验文件格式说明平台、存管行提供数据文件时，都需同时提供对应的汇总校验文件。每类数据文件后面增加3位序号，代表文件个数，超大数据的文件，需拆分为多个文件，按最大100万笔记录拆分多个文件，如未超过100万笔，则只生产1个文件，默认序号从001开始，如多个文件，则按实际从001排序到00N生成文件序号。注意：交易数据需按正常时间排序，并按顺序在对应序号的数据文件中提供；如先发生的交易

8、，在3位序号小的文件中提供，后发生的交易，如前面的交易已超100万笔，则需在后面序号大的文件中提供，不能扰乱前后数据时间顺序！汇总校验文件前缀为：CHK汇总校验文件名格式：汇总校验文件前缀_数据文件名(不含3位序号及前置下横线) 字段描述：汇总校验文件中，只有1行数据，值为对应数据文件的文件个数，如开户文件无需拆分只有1个，则文件内容为1，如交易转账文件记录数比较大，假如400万笔，按每100万笔拆分，则文件数为4，汇总校验文件内容中即为4。1.3 其他说明1.3.1. 金额单位说明1、 金额均以元为单位，例如，20.56元，写成：20.561.3.2. 日期和时间格式说明1、 日期统一为8位

9、，例如，2017年1月1日，写成：201701012、 时间统一为6位，例如，1时1分1秒，写成：0101011.3.3. 接口报文结构接口报文使用http+json的形式传输，采用RSA双向签名请求报文格式结点名称中文名称类型长度必填备注msg业务参数C是请参考表格下方样例merchId商户号C6是加密秘钥对应的商户signInfo签名C64是签名结果请求报文示例：signInfo:9c443319cdb6602cf13e31a8f886fc83,merchId:000001,msg:busType:TX, phoneNo :13800138000,orderId :201705200000

10、01, versionNo :1.00响应报文示例：signInfo:9c443319cdb6602cf13e31a8f886fc83, retCode :A000, retInfo :记账成功,data:orderId :20170520000001,status:021.3.4. 签名串说明1、 请求报文msg中的内容2、 响应报文data中的全部内容注：现在框架在升级改造中，后期才能在data 参数外面添加signInfo，开发时，先调用统一方法。1.3.5. 签名算法以 RSA(2048)算法作为签名算法。 签名算法分为两步： 1.商户生成一对公钥私钥，其中私钥加密，公钥解密（商户将公

11、钥提供给银管通平台，同时银管通平台会把自己的公钥提供给商户）。 2. 商户将签名的字符串用RSA加密成密文，放在signInfo内。 注意：签名时将字符串转化成字节流时指定的字符集 UTF-8 一致。第2章 接口说明2.1 接口列表序号接口名称接名称发起端服务端实时报文/文件1 短信验证码获取verifycode_getcode平台银行实时报文2 短信验证码验证verifycode_verify平台银行实时报文3 个人账户注册account_personal_register平台银行实时报文4 个人账户注册查询account_personal_query平台银行实时报文5 企业账户注册acco

12、unt_company_register平台银行实时报文6 企业账户注册查询account_company_query平台银行实时报文7 借贷合同同步contract_synchronize平台银行实时报文8 借贷合同查询contract_query平台银行实时报文9 债权转让合同同步transfercontract_synchronize平台银行实时报文10 债权转让合同查询transfercontract_query平台银行实时报文11 充值recharge_recharge平台银行实时报文12 充值查询recharge_query平台银行实时报文13 交易转账transfer平台银行实时

13、报文14 交易转账查询transfer_query平台银行实时报文15 提现withdraw平台银行实时报文16 提现查询withdraw_query平台银行实时报文17 风险金补偿transfer_risk平台银行实时报文18 风现金补偿查询transfer_risk_query平台银行实时报文19 违约还款transfer_repayment平台银行实时报文20 违约还款查询transfer_repayment_query平台银行实时报文21 销户account_cancel平台银行实时报文22 客户资金账户余额对账文件平台银行实时报文23 充值流水对账文件平台银行日终文件24 提现流水对

14、账文件平台银行日终文件25 转账流水对账文件平台银行日终文件26 风险金补偿对账文件平台银行日终文件27 违约还款对账文件平台银行日终文件2.2 实时接口说明2.2.1. 短信验证码2.2.1.1. 短信验证码获取请求报文结点名称中文名称类型长度必填备注versionNo版本号C4是1.00busType业务类型C8是TX：提现申请QT：其他phoneNo手机号C32是填“业务类型”对应接口的手机号，例如，如是提现短信验证码，则填银行卡预留手机号。orderId订单号C64是短信业务，保持订单号唯一响应报文结点名称中文名称类型长度必填备注orderId订单号C64是status状态C2是参照

15、状态编码 retCode响应码C4是参照 响应码编码 retInfo响应信息C255否交易失败时必填说明：1、 参见众邦银行短信签约的说明序号场景短信模板1提现申请待补充2.2.1.2. 短信验证码验证请求报文结点名称中文名称类型长度必填备注versionNo版本号C4是1.00busType业务类型C8是TX：提现申请QT：其他orderId订单号C64是短信业务，保持订单号唯一，只做通讯使用，不做其他查询chUserIdp2p平台用户号C64是p2p平台唯一，个人和企业的也不能重复amount交易金额C17是如果不涉及资金交易，金额为0，如果是提现交易，金额设置为提现金额。phoneNo手

16、机号C32是填“业务类型”对应接口的手机号，例如，如是提现短信验证码，则填银行卡预留手机号。verCode短信验证码C32否用户回填收到的短信验证码busDate业务日期C8是p2p平台的业务日期，提现交易需要传入此日期。格式：YYYYMMDDremark备注C255否备注信息，原样返回响应报文结点名称中文名称类型长度必填备注orderId订单号C64是status状态C2是参照 状态编码 msgTokenId银管通平台短信验证通过后的返回码C64否短信验证通过时必填投资人提现时需要传入此返回码retCode响应码C4是参照 响应码编码 retInfo响应信息C255否交易失败时必填2.2.2

17、. 账户（个人账户）2.2.2.1. 注册请求报文结点名称中文名称类型长度必填备注versionNo版本号C4是1.00chUserIdp2p平台用户号C64是p2p平台唯一，个人和企业的也不能重复busDate业务日期C8是p2p平台所属的交易日期格式：YYYYMMDDuserRole身份角色C1是0：出借人1：借款人customerName姓名C128是certificateId证件号码C64是证件号码certificateType证件类型C3是参见 证件类型编码email电子邮箱C64否address联系地址C255否phoneNo手机号C32是sendTime提交时间C14是格式：YY

18、YYMMDDHHMMSS,不足14位时，添加0补足14位remark备注C255否备注信息，原样返回响应报文结点名称中文名称类型长度必填备注chUserIdp2p平台用户号C64是p2p平台唯一，个人和企业的也不能重复merchIdp2p平台商户号C6是p2p平台在银管通商户号accStatus账户状态C2是参照 账户状态编码completeTime处理时间C14是YYYYMMDDHHMMSSretCode响应码C4是参照 响应码编码 retInfo响应信息C255否交易失败时必填待确认：1、 是否要对接公安部的ID5鉴权，进行核查？2、 是否要限制一个证件号码，在一个平台只能开一个投资账户、

19、一个借款账户3、 若公安部联网核查系统异常，存管行返回通过信息，待联网核查系统恢复正常后存管行再进行联网核查，并线下返回联网核查结果给平台。4、 如果重复提交开户请求，开户状态以查询结果为准，响应码为：0009-重复开户2.2.2.2. 账户查询请求报文结点名称中文名称类型长度必填备注versionNo版本号C4是1.00chUserIdp2p平台用户号C64是p2p平台唯一，个人和企业的也不能重复响应报文结点名称中文名称类型长度必填备注chUserIdp2p平台用户号C64是p2p平台唯一，个人和企业的也不能重复busDate业务日期C8是p2p平台所属的交易日期格式：YYYYMMDDuse

20、rRole身份角色C1是0：出借人1：借款人customerName姓名C128是certificateId证件号码C64是证件号码certificateType证件类型C3是参见 证件类型编码email电子邮箱C64否address联系地址C255否phoneNo手机号C32是ableAccBal可用余额C17是freezeAccBal冻结金额C17是remark备注C255否备注信息，原样返回retCode响应码C4是参照 响应码编码 retInfo响应信息C255否交易失败时必填2.2.3. 账户（企业账户）2.2.3.1. 注册请求报文结点名称中文名称类型长度必填备注versionNo

21、版本号C4是1.00chUserIdp2p平台用户号C64是p2p平台唯一，个人和企业的也不能重复certificateId证件号码C64是证件号码certificateType证件类型C3是参见 证件类型编码customerName企业名称C255是企业名称corpCertNo法人代表证件号C64是corpCertType法人代表证件类型C3是corpName法人代表姓名C128是contractName企业联系人姓名C128是phoneNo联系人手机号C32是email联系人邮箱C128否userRole身份角色C1是0：出借人1：借款人sendTime提交时间C14是格式：YYYYMMD

22、DHHMMSS,不足14位时，添加0补足14位remark备注C255否备注信息，原样返回响应报文结点名称中文名称类型长度必填备注chUserIdp2p平台用户号C64是p2p平台唯一，个人和企业的也不能重复merchIdp2p平台商户号C6是p2p平台在银管通商户号accStatus账户状态C2是参照 账户状态编码completeTime处理时间C14否YYYYMMDDHHMMSSretCode响应码C4是参照 响应码编码 retInfo响应信息C255否交易失败时必填说明：1、 商户在入网时，需要在管理后台自动开通服务费账户、风险金账户，并且需要支持在后台手动初始化服务费、风险金账户余额。

23、2、 企业开户的流程是：接口实时开户，但需要企业线下企业资料邮寄到监管行进行确认。2.2.3.2. 账户查询请求报文结点名称中文名称类型长度必填备注versionNo版本号C4是1.00chUserIdp2p平台用户号C64是p2p平台唯一，个人和企业的也不能重复响应报文结点名称中文名称类型长度必填备注chUserIdp2p平台用户号C64是p2p平台唯一，个人和企业的也不能重复certificateId证件号码C64是证件号码certificateType证件类型C3是参见 证件类型编码customerName企业名称C255是企业名称corpCertNo法人代表证件号C64是corpCer

24、tType法人代表证件类型C3是corpName法人代表姓名C128是contractName企业联系人姓名C128是phoneNo联系人手机号C32是email联系人邮箱C128否userRole身份角色C1是0：出借人1：借款人sendTime提交时间C14是格式：YYYYMMDDHHMMSS,不足14位时，添加0补足14位remark备注C255否备注信息，原样返回ableAccBal可用余额C17是freezeAccBal冻结金额C17是remark备注C255否备注信息，原样返回retCode响应码C4是参照 响应码编码 retInfo响应信息C255否交易失败时必填2.2.4. 借

25、贷合同2.2.4.1. 借贷合同同步请求报文结点名称中文名称类型长度必填备注versionNo版本号C4是1.00contractNo合同号C64是p2p平台唯一busDate业务日期C8是p2p平台所属的日期格式：YYYYMMDDcontractType合同类型C1是0：普通合同1：委托代付合同curdFlag接口标识C1是0：新增1：修改toChUserIdp2p平台借款人用户号/受托人C64是p2p平台唯一toNamep2p平台借款人/受托人名称C255是fromChUserIdp2p平台出借人用户号/委托人C64是fromNamep2p平台出借人名称/委托人C255是amount合同金

26、额C17是rate借款利率C10是以%为单位effectiveDate合同生效日C8是YYYYMMDDexpireDate合同到期日C8是YYYYMMDDrepayDate还款日C8是DDrepayDateType还款日类型C1是0：每月，1：每季，2：到期日，3：其他repayPeriods还款期数C10是sendTime提交时间C14是YYYYMMDDHHMMSSremark备注C255否备注信息，原样返回响应报文结点名称中文名称类型长度必填备注contractNo合同号C64是p2p平台唯一merchIdp2p平台商户号C6是p2p平台在银管通商户号contractStatus合同状态C

27、2是02 成功03 失败completeTime处理时间C14否YYYYMMDDHHMMSSretCode响应码C4是参照 响应码编码 retInfo响应信息C255否交易失败时必填说明：1、 合同信息只能新增，不能修改是否还需要修改合同信息。是否还需要判断提前还款？2、 委托合同说明，以该场景举例说明： 假设有该场景：消费者（A）在线上商城（B）上使用分期还款方式买了一款商品，B在平台上发标，C和D投标。则A、B、C、D的合同关系为：A（借款人）和C（投资人）、D（投资人）形成普通合同；A（委托人）和B（受托人）形成委托合同。以下是合同、借款、还款三个阶段的交易流程：2.2.4.2. 借贷合

28、同查询请求报文结点名称中文名称类型长度必填备注versionNo版本号C4是1.00contractNo合同号C64是p2p平台唯一busDate业务日期C8是p2p平台所属的日期格式：YYYYMMDD响应报文结点名称中文名称类型长度必填备注contractNo合同号C64是p2p平台唯一busDate业务日期C8是p2p平台所属的日期格式：YYYYMMDDcontractType合同类型C1是0：普通合同1：委托代付合同toChUserIdp2p平台借款人用户号/受托人C64是p2p平台唯一toNamep2p平台借款人/受托人名称C255是fromChUserIdp2p平台出借人用户号/委托

29、人C64是fromNamep2p平台出借人名称/委托人C255是amount合同金额C17是rate借款利率C10是以%为单位effectiveDate合同生效日C8是YYYYMMDDexpireDate合同到期日C8是YYYYMMDDrepayDate还款日C8是DDrepayDateType还款日类型C1是0：每月，1：每季，2：到期日，3：其他repayPeriods还款期数C10是completeTime处理时间C14否YYYYMMDDHHMMSSremark备注C255否备注信息，原样返回retCode响应码C4是参照 响应码编码 retInfo响应信息C255否交易失败时必填2.2

30、.5. 债权转让合同2.2.5.1. 债权转让合同同步请求报文结点名称中文名称类型长度必填备注versionNo版本号C4是1.00contractNo合同号C64是p2p平台唯一busDate业务日期C8是p2p平台所属的日期格式：YYYYMMDDcurdFlag接口标识C1是0：新增1：修改contractType合同类型C1是2：债权转让合同orglContractNo原始借贷合同号C64是债权对应的原始借贷合同编号fromChUserId受让用户号C64是fromName受让人姓名C128是toChUserId转让人用户号C64是toName转让人姓名C128是amount债权转让合同

31、金额C17是rate借款利率C10是effectiveDate合同生效日C8是YYYYMMDDexpireDate合同到期日C8是YYYYMMDDsendTime提交时间C14是YYYYMMDDHHMMSSremark备注C255是备注信息，原样返回响应报文结点名称中文名称类型长度必填备注contractNo合同号C64是p2p平台唯一merchIdp2p平台商户号C6是p2p平台在银管通商户号contractStatus合同状态C2是02 成功03 失败completeTime处理时间C14否YYYYMMDDHHMMSSretCode响应码C4是参照 响应码编码 retInfo响应信息C25

32、5否交易失败时必填说明：2.2.5.2. 债权转让合同查询请求报文结点名称中文名称类型长度必填备注versionNo版本号C4是1.00contractNo合同号C64是p2p平台唯一busDate业务日期C8是p2p平台所属的日期格式：YYYYMMDD响应报文结点名称中文名称类型长度必填备注contractNo合同号C64是p2p平台唯一busDate业务日期C8是p2p平台所属的日期格式：YYYYMMDDcurdFlag接口标识C1是0：新增1：修改contractType合同类型C1是2：债权转让合同orglContractNo原始借贷合同号C64是债权对应的原始借贷合同编号fromCh

33、UserId受让用户号C64是fromName受让人姓名C128是toChUserId转让人用户号C64是toName转让人姓名C128是amount债权转让合同金额C17是rate借款利率C10是effectiveDate合同生效日C8是YYYYMMDDexpireDate合同到期日C8是YYYYMMDDcompleteTime处理时间C14否YYYYMMDDHHMMSSremark备注C255是备注信息，原样返回retCode响应码C4是参照 响应码编码 retInfo响应信息C255否交易失败时必填2.2.6. 充值2.2.6.1. 充值请求报文结点名称中文名称类型长度必填备注versi

34、onNo版本号C4是1.00chUserIdp2p平台用户号C64是p2p平台唯一orderId订单号C64是p2p平台订单号amount充值金额C17是bankAccNo银行卡号C32否phoneNo银行预留手机号C32否payCompany第三方支付机构C20是参见 三方支付机构编码payNo支付流水号C100否第三方支付机构返回p2p平台的支付流水号notifyUrl异步通知地址C255否必须是http开头的公网地址，通知地址中不能含有?等特殊字符busDate业务日期C8是p2p平台所属的日期格式：YYYYMMDDsendTime提交时间C14是YYYYMMDDHHMMSSremark

35、备注C255是备注信息，原样返回响应报文结点名称中文名称类型长度必填备注orderId订单号C64是p2p平台唯一merchIdp2p平台商户号C6是p2p平台在银管通商户号txnId银管通流水号C128否交易成功时必填status交易状态C2是参见 交易状态编码completeTime处理时间C14否YYYYMMDDHHMMSSretCode响应码C4是参照 响应码编码 retInfo响应信息C255否交易失败时必填2.2.6.2. 充值查询请求报文结点名称中文名称类型长度必填备注versionNo版本号C4是1.00orderId订单号C64是p2p平台订单号busDate业务日期C8是p

36、2p平台所属的日期格式：YYYYMMDD响应报文结点名称中文名称类型长度必填备注versionNo版本号C4是1.00chUserIdp2p平台用户号C64是p2p平台唯一merchIdp2p平台商户号C6是p2p平台在银管通商户号orderId订单号C64是p2p平台订单号amount充值金额C17是bankAccNo银行卡号C32否phoneNo银行预留手机号C32否payCompany第三方支付机构C20是参见 三方支付机构编码payNo支付流水号C100否第三方支付机构返回p2p平台的支付流水号busDate业务日期C8是p2p平台所属的日期格式：YYYYMMDDcompleteTime处理时间C14否YYYYMMDDHHMMSStxnId银管通流水号C128否交易成功时必填remark备注C255是备注信息