一、2336-数字证书活体意愿双录接口
1. 接口功能
通过姓名和身份证号码选择验证方式（静默活体或意愿双录）进行活体验证。
2.报文结构
请求报文：
| 报文元素 | 出现要求 | 非空约束 | 数据格式 | 说明 |
| TxCode | R | NOT NULL | N1..4 | 交易类型 |
| InstitutionID | R | NOT NULL | ANS1..8 | 机构编号 |
| TxSN | R | NOT NULL | ANS1..32 | 交易流水号 |
| Name | R | NOT NULL | ANS1..50 | 姓名 |
| R | NOT NULL | N1 | 身份证件号码 | |
| FrontUrl | R | NOT NULL | ANS1..512 | 前台通知地址 |
| BackUrl | R | NOT NULL | ANS1..512 | 后台通知地址 |
| O | NOT NULL | N1 | 页面通知方式，不出现时，默认POST 0-POST 1-GET |
|
| AuthType | R | NOT NULL | N2 | 验证类型： 10-静默活体 20-静默活体（附照片） 30-意愿双录 40-意愿双录（附照片） |
| WillContent | O | NOT NULL | ANS1..100 | 意愿确认语音播报内容（验证类型为30、40是不能为空） |
| WillAnswer | O | NOT NULL | ANS1..20 | 意愿答案（验证类型为30、40是不能为空） |
| 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 | 交易流水号 |
| Url | C | NOT NULL | ANS1..32 | 活体验证地址 |
二、2337-数字证书活体意愿双录结果通知报文
1.接口功能
活体验证结果主动通知接口。由数据平台主动向机构推送报文机构在接到通知后，需向数据平台响应。当数据平台收到机构经过Base64加密之后的，Code:2000 , Message:SUCCESS 时，默认为接收成功。若没有及时返回，数据平台会在10分钟内下发三次。之后不再下发，默认为接收失败。
直接响应eyJDb2RlIjoiMjAwMCIsIk1lc3NhZ2UiOiJTVUNDRVNTIn0=即可
2. 报文结构
请求报文：
| 报文元素 | 出现要求 | 非空约束 | 格式说明 | 说明 |
| 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 | 交易跟踪号 |
| C | NOT NULL | N0..4 | 通道响应代码 | |
| C | NOT NULL | ANS0..256 | 通道响应消息 | |
| Verification | C | NOT NULL | N2 | 验证状态 |
| 10=未知 | ||||
| 20=识别验证匹配 | ||||
| 30=验证不匹配 |
响应报文：
| 报文元素 | 出现要求 | 非空约束 | 数据格式 | 说明 |
| Code | R | NOT NULL | N4 | 响应代码 |
| Message | R | NOT NULL | N6 | 响应消息 |
三、2337-数字证书活体意愿双录结果查询
1. 接口功能
通过原始交易流水号主动查询活体验证结果。
2. 报文结构
请求报文：
| 报文元素 | 出现要求 | 非空约束 | 数据格式 | 说明 |
| TxCode | R | NOT NULL | N1..4 | 交易类型 |
| InstitutionID | R | NOT NULL | ANS1..8 | 机构编号 |
| TxSN | R | NOT NULL | ANS1..32 | 交易流水号 |
| R | NOT NULL | ANS1..32 | 原始交易流水号 | |
| AuthType | R | NOT NULL | N2 | 验证类型： 10-静默活体 20-静默活体（附照片） 30-意愿双录 40-意愿双录（附照片） |
| 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 | 交易流水号 |
| C | NOT NULL | ANS1..32 | 原始交易流水号 | |
| TraceNo | C | NOT NULL | ANS1..32 | 交易跟踪号 |
| C | NOT NULL | N0..4 | 通道响应代码 | |
| C | NOT NULL | ANS0..256 | 通道响应消息 | |
| Verification | C | NOT NULL | N2 | 验证状态 10=未知 20=识别验证匹配 30=验证不匹配 40=用户操作超时 |
四.报文样例
[!TIP] （测试数据不校验数据真实性，默认为验证结果为匹配，若验证其他结果，可查看“总体规范-6.1.2.4 Remark 备注”）
1.2236报文样例(验证类型为30-意愿双录)
请求报文(InstitutionID由中金分配)：
{
"FrontUrl":"https://172.31.4.66/DSPInstitutionSimulatorTest/ReceiveNoticePage",
"WillContent":"本次业务全程录音录像，请问您是否明白，请回答“明白”",
"FrontMethod":"0",
"TxCode":"2336",
"IdentificationNumber":"110101198001010037",
"InstitutionID":"XXXXXX",
"WillAnswer":"明白",
"TxSN":"202507110939554761003028994",
"AuthType":"30",
"BackUrl":"https://172.31.4.66/DSPInstitutionSimulatorTest/ReceiveNoticeBackground",
"Remark":"",
"Name":"小王"
}
响应报文：
{
"TxCode":"2336",
"Message":"SUCCESS",
"InstitutionID":"XXXXXX",
"TxSN":"202507110939554761003028994",
"Code":"2000",
"Url":"https://dsptest.cpcn.com.cn/DSPLivenessWeb/InterfaceI?token=eyJhbGciOiJIUzUxMiJ9.eyJpbnN0aXR1dGlvbklEIjoiMDAwMDIwIiwidHhUaW1lIjoiMjAyNTA3MTEwOTQwMjIiLCJ0eFNOIjoiMjAyNTA3MTEwOTM5NTU0NzYxMDAzMDI4OTk0IiwidHhDb2RlIjoiMjMzNiJ9.Qgb7pPEBLJItPD_8nI81_2BQrh8HWeoostPuQaCjBXR_JRbYcVxmmmZYR9TduYUACo0cV--PVWTAkfUfn8SG2Q",
"TraceNo":"2507110940223671112014459"
}
2.2237后台通知报文样例（中金发送请求）
请求报文：
{
"Code":"2000",
"InstitutionID":"XXXXXX",
"Message":"SUCCESS",
"ResponseCode":"0000",
"ResponseMessage":"匹配",
"TraceNo":"2507110940475321612017589",
"TxCode":"2337",
"TxSN":"202507110939554761003028994",
"Verification":"20"
}
3.2237查询报文样例
请求报文(InstitutionID由中金分配)：
{
"TxCode":"2337",
"InstitutionID":"XXXXXX",
"TxSN":"202507141024294620584621764",
"OriginalTxSN":"202507110939554761003028994",
"AuthType":"30",
"Remark":""
}
响应报文：
{
"ResponseCode":"0000",
"TxCode":"2337",
"Message":"SUCCESS",
"InstitutionID":"XXXXXX",
"TxSN":"202507141024294620584621764",
"OriginalTxSN":"202507110939554761003028994",
"Verification":"20",
"ResponseMessage":"匹配",
"Code":"2000",
"TraceNo":"2507141024595071112016507"
}
该文档未解决您的疑问？
查看常见问题