2334-小程序人脸识别
1. 接口功能
小程序人脸识别(炫彩活体、唇语随机数)获取url。
根据姓名、身份证号和上传的视频，验证操作人真实性。上送身份信息之后会返回活体URL，客户通过URL进入活体流程。之后数据平台会从客户完成的活体视频中随机截取一张图片，然后根据拿到的身份信息与图片到公安库中进行比对。最后返回验证结果。
FrontUrl为用户完成或取消验证后网页跳转的目标URL。通知方式支持POST和GET，GET方式不包含请求参数，仅重定向到FrontUrl的页面。POST方式包含请求参数,解密报文后即可拿到活体认证结果。可参考示例程序ReceiveNoticePage.java
Backurl用户完成验证、取消验证、或验证超时后，请求接口调用方服务器的URL。通知内容与页面通知（POST方式）内容完全一致，为页面通知的补偿机制。可参考示例程序ReceiveNoticeBackground.java
注意：
1.微信小程序嵌套H5需要添加业务域名，商户端小程序接入中金支付时不允许添加中金支付公司的域名，因此商户需要用自己的域名，并配置反向代理。(测试环境配置附件《微信小程序H5反向代理方案-对外测试》，生产配置文件《微信小程序H5反向代理方案-生产环境》。
2.FrontMethod为GET没有通知报文的解决方式：交易流水号TxSN拼接到FrontUrl中，接收到页面回调后，调用2333接口进行主动查询。
3.机构方有网络限制需要添加数据平台IP:106.38.206.2、111.202.233.61、106.120.182.92添加白名单，活体结果通过2319接口通知到机构方。
4.商户代理域名InstitutionUrl参数只支持https协议和域名配置。
2.接口时序图
3.报文结构
请求报文：
| 报文元素 | 出现要求 | 非空约束 | 数据格式 | 说明 |
|---|---|---|---|---|
| TxCode | R | NOT NULL | N1..4 | 交易类型 |
| InstitutionID | R | NOT NULL | ANS1..8 | 机构编号 |
| TxSN | R | NOT NULL | ANS1..32 | 交易流水号 |
| Name | R | NOT NULL | ANS1..50 | 姓名 |
| ReturnImage | O | NOT NULL | ANS1..32 | 是否返照片，不出现时，默认不返照片 0 =不返 1 = 返照片 |
| IdentificationNumber | R | NOT NULL | N1 | 身份证件号码 |
| FrontUrl | R | NOT NULL | ANS1..512 | 前台通知地址 |
| BackUrl | R | NOT NULL | ANS1..512 | 后台通知地址 |
| FrontMethod | O | NOT NULL | ANS0..64 | 页面通知方式，不出现时，默认POST 0 = POST 1 = GET |
| Remark | O | N1 | 备注 | |
| Threshold | O | ANS2 | 档位，为空时，默认T5： T3 T4 T5 T6 |
|
| InstitutionUrl | R | NOT NULL | ANS1..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..512 | 人脸识别页面地址 |
4.报文样例
[!TIP] （测试数据不校验数据真实性，默认为验证结果为匹配，若验证其他结果，可查看“总体规范-6.1.2.4 Remark 备注”）
请求报文(InstitutionID由中金分配)：
{
"FrontUrl":"https://172.31.4.66/DSPInstitutionSimulatorTest/ReceiveNoticePage",
"ReturnImage":"0",
"FrontMethod":"0",
"TxCode":"2334",
"IdentificationNumber":"430522199209122671",
"InstitutionUrl":"https://dsptest.cpcn.com.cn/",
"InstitutionID":"XXXXXX",
"TxSN":"202212121026524571285094545",
"BackUrl":"https://172.31.4.66/DSPInstitutionSimulatorTest/ReceiveNoticeBackground",
"Remark":"",
"Name":"王测试",
"Threshold":"T5"
}
响应报文：
{
"TxCode":"2334",
"Message":"SUCCESS",
"InstitutionID":"XXXXXX",
"TxSN":"202212121026524571285094545",
"Code":"2000",
"Url":"https://dsptest.cpcn.com.cn/DSPLivenessWeb/InterfaceItoken=eyJhbGciOiJIUzUxMiJ9.eyJpbnN0aXR1dGlvbklEIjoiMDAwMDIwIiwidHhUaW1lIjoiMjAyMjEyMTIxMDE3MTAiLCJ0eFNOIjoiMjAyMjEyMTIxMDEzNTYzODkxMjU3MzI0MTQ5IiwidHhDb2RlIjoiMjMzNCJ9.57VtBKdR5PdU8bVunK3KmSNbYNZ_nSjRxYCgshf7T0Jx-Dc6HsnDw-ynClATOmuq1AgG4Lbc2KwIq2PB5zccgw",
"TraceNo":"2212121017101961112013326"
}
该文档未解决您的疑问？
查看常见问题