2311-SDK人脸核身V5验证

1. 接口功能

​ 上传核验人员姓名、证件号码和BizToken获取活体验证结果。

2. 报文结构

​ 请求报文:

报文元素 出现要求 非空约束 数据格式 说明
TxCode R NOT NULL N1..4 交易类型
InstitutionID R NOT NULL ANS1..8 机构编号
TxSN R NOT NULL ANS1..32 交易流水号
Name R NOT NULL AN1..50 姓名
IdentificationNumber
R NOT NULL AN1..50 证件号码
Threshold O ANS2 档位
T3
T4
T5
T6
BizToken R NOT NULL ANS1..256 BizToken值(调用2310接口返回的bizToken)
ReturnImage
O N1 是否返照片,不出现时,默认不返照片
0-不返
1-返照片
Remark O ANS0..256 备注

​ 响应报文:

报文元素 出现要求 非空约束 数据格式 说明
TxCode R NOT NULL N1..4 交易类型
InstitutionID R NOT NULL ANS1..8 机构编号
TxSN R NOT NULL ANS1..32 交易流水号
Name R NOT NULL AN1..50 姓名
IdentificationNumber
R NOT NULL AN1..50 证件号码
Threshold O ANS2 档位
T3
T4
T5
T6
BizToken R NOT NULL ANS1..256 BizToken值(调用2310接口返回的bizToken)
ReturnImage
O N1 是否返照片,不出现时,默认不返照片
0-不返
1-返照片
Remark O ANS0..256 备注

3.报文样例:

[!TIP] (测试数据不校验数据真实性,默认为验证结果为匹配,若验证其他结果,可查看“总体规范-6.1.2.4 Remark 备注”)

请求报文(InstitutionID由中金分配):

{
    "ReturnImage":"0",
    "TxCode":"2311",
    "IdentificationNumber":"110101198001010037",
    "InstitutionID":"XXXXXX",
    "TxSN":"202510140926407024355805508",
    "BizToken":"1713944376,81770a43-c935-4eb9-a11e-7a2f6df5c776",
    "Remark":"",
    "Threshold":"T5",
    "Name":"小王"
}

响应报文:

{
    "VerificationScore":"80",
    "ResponseCode":"0000",
    "TxCode":"2311",
    "Message":"SUCCESS",
    "InstitutionID":"XXXXXX",
    "VerifyThreshold":{
        "T4":"69.315",
        "T5":"74.399",
        "T6":"78.038",
        "T3":"62.169"
    },
    "TxSN":"202510140926407024355805508",
    "Verification":"20",
    "ResponseMessage":"匹配",
    "Code":"2000",
    "VideoKey":"0ec608c4",
    "TraceNo":"2510141543533571112016996"
}

该文档未解决您的疑问?png 查看常见问题

Copyright © China Financial Digital Technology Co., Ltd. all right reserved,powered by Gitbook该文章修订时间: 2026-01-21 11:58:59

results matching ""

    No results matching ""