一、5102-个人风险报告查询人力版
1. 接口功能
通过姓名、身份证号码和手机号来查询报告的生成状态。
2.报文结构
请求报文：
| 报文元素 | 出现要求 | 非空约束 | 数据格式 | 说明 |
| TxCode | R | NOT NULL | N1..4 | 交易类型 |
| InstitutionID | R | NOT NULL | ANS1..8 | 机构编号 |
| TxSN | R | NOT NULL | ANS1..32 | 交易流水号 |
| Remark | O | ANS0..256 | 备注 | |
| Name | R | NOT NULL | ANS1..50 | 姓名 |
| IdentificationNumber | R | NOT NULL | N1..32 | 身份证号 |
| PhoneNumber | R | NOT NULL | N1..11 | 手机号 |
| BackUrl | ANS1..512 | 后台通知地址 | ||
| AuthFlag | R | NOT NULL | N2 | 是否获得授权： 20-获得授权 |
| SerialNm | R | NOT NULL | ANS32 | C 端客户向终端商户进行信息核验 (或查询)的 个人信息使用授权协议签署的流水号 |
响应报文：
| 报文元素 | 出现要求 | 非空约束 | 数据格式 | 说明 |
| Code | R | NOT NULL | N1..6 | 响应代码 |
| Message | R | NOT NULL | ANS1..256 | 响应消息 |
| TxCode | C | NOT NULL | ANS1..4 | 交易类型 |
| InstitutionID | C | NOT NULL | ANS1..8 | 机构号 |
| TxSN | C | NOT NULL | ANS1..32 | 交易流水号 |
| TraceNo | C | NOT NULL | ANS1..32 | 交易跟踪号 |
| ProcessStatus | C | NOT NULL | #N/A | 报告生成状态 10=初始化 15=处理中 20=报告已生成 |
二、5119-个人风险报告通知报文
1. 接口功能
由数据平台主动向机构推送报文。主要推送5102接口报告生成状态为“10-初始化”的交易结果。机构在接到通知后，需向数据平台响应。当数据平台收到机构经过Base64加密之后的，Code:2000 , Message:SUCCESS 时，默认为接收成功。若没有及时返回，数据平台会在10分钟内下发三次。之后不再下发，默认为接收失败。
2.报文结构
请求报文：
| 报文元素 | 出现要求 | 非空约束 | 说明 | |
| Code | R | NOT NULL | N1..6 | 响应代码 |
| Message | R | NOT NULL | ANS1..256 | 响应消息 |
| TxCode | C | NOT NULL | ANS1..4 | 通知编码 |
| OriginalTxCode | C | NOT NULL | #N/A | 原交易类型 |
| InstitutionID | C | NOT NULL | ANS1..8 | 机构编号 |
| TxSN | C | NOT NULL | ANS1..32 | 交易流水号 |
| TraceNo | C | NOT NULL | ANS1..32 | 交易跟踪号 |
| ProcessStatus | C | NOT NULL | #N/A | 报告生成状态 20=报告已生成 |
响应报文：
| 报文元素 | 出现要求 | 非空约束 | 数据格式 | 说明 |
| Code | R | NOT NULL | N4 | 响应代码 |
| Message | R | NOT NULL | N6 | 响应消息 |
二、5115-个人风险报告结果查询
1. 接口功能
个人风险报告结果查询。
2.报文结构
请求报文：
| 报文元素 | 出现要求 | 非空约束 | 数据格式 | 说明 |
|---|---|---|---|---|
| TxCode | R | NOT NULL | N1..4 | 交易类型 |
| InstitutionID | R | NOT NULL | ANS1..8 | 机构编号 |
| TxSN | R | NOT NULL | ANS1..32 | 交易流水号 |
| OriginalTxCode | R | NOT NULL | N1..4 | 原交易类型 |
| OriginalTxSN | R | NOT NULL | ANS1..32 | 原始交易流水号 |
| Remark | O | ANS0..256 | 备注 |
响应报文：
| 报文元素 | 出现要求 | 非空约束 | 数据格式 | 说明 |
|---|---|---|---|---|
| Code | R | NOT NULL | N1..6 | 响应代码 |
| Message | R | NOT NULL | ANS1..256 | 响应消息 |
| TxCode | C | NOT NULL | ANS1..4 | 交易类型 |
| InstitutionID | C | NOT NULL | ANS1..8 | 机构编号 |
| TxSN | C | NOT NULL | ANS1..32 | 交易流水号 |
| OriginalTxSN | C | NOT NULL | ANS1..32 | 原始交易流水号 |
| TraceNo | C | NOT NULL | ANS1..32 | 交易跟踪号 |
| Base64docx | C | clob | word报告文件,base64编码 |
三、报文样例
[!TIP] （测试数据不校验数据真实性，默认为验证结果为匹配，若验证其他结果，可查看“总体规范-6.1.2.4 Remark 备注”）
1.5102报文样例
请求报文(InstitutionID由中金分配)：
{
"TxCode":"5102",
"IdentificationNumber":"110101198001010037",
"InstitutionID":"XXXXXX",
"AuthFlag":"20",
"SerialNm":"20240211",
"TxSN":"20241121172709300576551317",
"PhoneNumber":"18846439987",
"BackUrl":"https://172.31.4.66/DSPInstitutionSimulatorTest/ReceiveNoticeBackground",
"Remark":"",
"Name":"小王"
}
响应报文：
{
"TxCode":"5102",
"Message":"SUCCESS",
"InstitutionID":"XXXXXX",
"ProcessStatus":"10",
"TxSN":"20241121172709300576551317",
"Code":"2000",
"TraceNo":"2411211727317661112014417"
}
2.5119报文样例
请求报文(InstitutionID由中金分配)：
{
"Code":"2000",
"InstitutionID":"XXXXXX",
"Message":"SUCCESS",
"OriginalTxSN":"20241121172709300576551317",
"ProcessStatus":"20",
"TraceNo":"2411211728000055297193389",
"TxCode":"5119"
}
3.5115报文样例
请求报文(InstitutionID由中金分配)：
{
"TxCode":"5115",
"InstitutionID":"XXXXXX",
"OriginalTxCode":"5102",
"TxSN":"202411221422538324081537522",
"OriginalTxSN":"20241121172709300576551317",
"Remark":""
}
响应报文：
{
"TxCode":"5115",
"Base64docx":"UEsDBBQACAgIAICLdVkAAAAAAAAAAAA****AlAKgJAABMJRQAAAA=",
"Message":"SUCCESS",
"InstitutionID":"XXXXXX",
"TxSN":"202411221422538324081537522",
"Code":"2000",
"TraceNo":"2411221423151211112017994"
}
该文档未解决您的疑问？
查看常见问题