2319-活体验证验证结果通知
1. 接口功能
2319为活体验证结果的通知。由数据平台主动向机构推送报文。主要推送2312 、2314 、2324 、2317、2334这几个接口的交易结果。机构在接到通知后，需向数据平台响应。当数据平台收到机构经过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 | 交易跟踪号 | |||||
| ResponseCode | C | NOT NULL | N0..4 | 通道响应代码 | |||||
| ResponseMessage | C | NOT NULL | ANS0..256 | 通道响应消息 | |||||
| Verification | C | NOT NULL | N2 | 验证状态 | |||||
| 10=未知 | |||||||||
| 20=识别验证匹配 | |||||||||
| 30=验证不匹配 | |||||||||
| 40=用户操作超时 | |||||||||
| Image | O | ANS0.. | 采集照片，Base64编码 | ||||||
| VerificationScore | C | NOT NULL | ANS0..8 | 人脸验证得分 | |||||
| VerifyThreshold | T3 | C | NOT NULL | ANS0..8 | 风险为千分之一的验证门槛 | ||||
| T4 | C | NOT NULL | ANS0..8 | 风险为万分之一的验证门槛 | |||||
| T5 | C | NOT NULL | ANS0..8 | 风险为十万分之一的验证门槛（T5为默认验证标准） | |||||
| T6 | C | NOT NULL | ANS0..8 | 风险为百万分之一的验证门槛 | |||||
| Threshold | C | NOT NULL | ANS2 | 档位： | |||||
| T3 | |||||||||
| T4 | |||||||||
| T5 | |||||||||
| T6 | |||||||||
注意：
VerificationScore、VerifyThreshold和Threshold只有请求的是2324、2334接口时会在通知时返回。
响应报文：
| 报文元素 | 出现要求 | 非空约束 | 数据格式 | 说明 |
|---|---|---|---|---|
| Code | R | NOT NULL | N4 | 响应代码 |
| Message | R | NOT NULL | N6 | 响应消息 |
3. 报文样例
[!TIP] （测试数据不校验数据真实性，默认为验证结果为匹配，若验证其他结果，可查看“总体规范-6.1.2.4 Remark 备注”）
请求报文：（由中金请求）
通知类接口，请求报文由数据平台方下发。
{
"Code":"2000",
"InstitutionID":"XXXXXX",
"Message":"SUCCESS",
"ResponseCode":"0000",
"ResponseMessage":"匹配",
"Threshold":"T5",
"TraceNo":"2211281726417881612012388",
"TxCode":"2319",
"TxSN":"202211281726317857652588822",
"Verification":"20",
"VerificationScore":"88",
"VerifyThreshold":{"T3":"62.169","T4":"69.315","T5":"74.399","T6":"78.038"}
}
响应报文：（由商户响应）
此为商户收到平台方下发通知后，机构方需给平台方的固定返回。
{
"Code":"2000",
"Message":"SUCCESS"
}
该文档未解决您的疑问？
查看常见问题