身份证人脸比对
通过姓名、身份证号、人脸照片三者一致性进行身份核验。
产品概述
通过姓名、身份证号码、人脸照片三者的一致性来进行身份核验。
接口说明
- 请求地址：由服务方提供
- 请求方式：HTTP POST
- 请求格式：
application/x-www-form-urlencoded - 响应格式：
application/json - 超时时间：默认 20s
照片说明
- 支持 jpg、jpeg、bmp、png 格式
- 照片为生活照，图片大小尽量 0～30KB
- 像素不宜太低
- 请勿反光、污损、模糊
- 请勿强曝光、逆光、背光
- 勿遮挡人脸，勿戴口罩、墨镜
请求参数
| 参数 | 描述 | 是否必填 | 说明 |
|---|---|---|---|
| parMerCode | 主商户号 | 是 | 商户一级账号，由服务方提供 |
| merAcct | 商户账号 | 是 | 商户二级账号，由服务方提供 |
| appKey | 商户密钥 | 否 | 加签所需密钥，由服务方提供，入参不传此值 |
| signature | 签名值 | 是 | 报文加签后的值，见通用约定 |
| productType | 产品类型 | 是 | 见各接口附录 |
| merserialNo | 商户流水号 | 否 | 最长 36 位，建议上送便于双方查询交易 |
| userName | 姓名 | 是 | |
| idNum | 证件号 | 是 | |
| imageBase64 | 照片 base64 码 | 是 | 需要比对本人照片 |
请求示例
响应参数
| 参数 | 描述 | 是否必返 | 说明 |
|---|---|---|---|
| respCode | 返回码 | 是 | 见各接口附录 |
| respMsg | 返回信息 | 是 | 见各接口附录 |
| data | data 数据域 | 是 | 返回请求信息及我司订单号 |
data 数据域
| 子参 | 描述 | 是否必返 | 说明 |
|---|---|---|---|
| parMerCode | 主商户号 | 是 | 原样返回 |
| merAcct | 商户账号 | 是 | 原样返回 |
| productType | 产品类型 | 是 | 原样返回 |
| transCode | 交易流水号 | 否 | 我司交易流水号（订单号） |
| userName | 姓名 | 是 | |
| idNum | 证件号 | 是 |
datarow 数据域
| 子参 | 描述 | 是否必返 | 说明 |
|---|---|---|---|
| score | 相似度分值 | 是 | [0,600) 不同人；[600,700) 不确定；[700,1000] 同一人 |
应答示例
附录
产品类型字典
| 产品类型枚举值 | 产品类型含义 |
|---|---|
| PIDF | 身份证人脸比对 |
返回码及信息字典
| 返回码 | 返回信息 | 是否计费 |
|---|---|---|
| PIDF00 | 身份证号与姓名匹配，照片为同一人 | 是 |
| PIDF01 | 身份证号与姓名匹配，照片不能确定为同一人 | 是 |
| PIDF02 | 身份证号与姓名匹配，照片为不同人 | 是 |
| PIDF03 | 身份证号与姓名不匹配 | 是 |
| PIDF04 | 库中无此身份证号 | 否 |
| PIDF05 | 照片质量不合格 | 否 |
| PIDF06 | 身份证号与姓名匹配，库中无照片 | 是 |
| PIDF07 | 身份证号与姓名匹配，照片检测失败 | 是 |
| ID | 身份证号有误 | 是 |
| NM | 姓名有误 | 是 |
| LM | 交易过于频繁或次数超限 | 否 |
| ER | 交易异常 | 否 |
| OT | 交易超时/资源方超时 | 否 |
| SE | 系统异常 | 否 |
| DE | 请求数据有误 | 否 |
| SF | 验签失败 | 否 |
| PD | 权限不足 | 否 |
| AR | 账户余额不足 | 否 |
| TNS | 该产品服务暂不可用 | 否 |
加签说明与 Java Demo 见通用约定。