身份证人脸比对

通过姓名、身份证号、人脸照片三者一致性进行身份核验。

产品概述

通过姓名、身份证号码、人脸照片三者的 consistency 来进行身份核验。

接口说明

  • 请求地址：由服务方提供
  • 请求方式：HTTP POST
  • 请求格式：application/x-www-form-urlencoded
  • 响应格式：application/json
  • 超时时间：默认 10s

照片说明

  1. 支持 jpg、jpeg、bmp、png 格式
  2. 照片为生活照，图片大小尽量 0～30KB
  3. 像素不宜太低
  4. 请勿反光、污损、模糊
  5. 请勿强曝光、逆光、背光
  6. 勿遮挡人脸，勿戴口罩、墨镜

请求参数

参数描述是否必填说明
parMerCode主商户号是商户一级账号，由服务方提供
merAcct商户账号是商户二级账号，由服务方提供
appKey商户密钥否加签所需密钥，由服务方提供，入参不传此值
productType产品类型是见各接口附录
merserialNo商户流水号否最长 36 位，建议上送便于双方查询交易
signature签名值是报文加签后的值，见通用约定
userName姓名是
idNum证件号是
imageBase64照片 base64 码是需要比对本人照片

请求示例

POST 请求体为 application/x-www-form-urlencoded（非 JSON），appKey 不入参。Body 示例：

parMerCode=主商户号&merAcct=商户账号&productType=PIDF&merserialNo=商户流水号&userName=张三&idNum=身份证号&imageBase64=照片base64码&signature=加签后的签名值

响应参数

参数描述是否必返说明
respCode返回码是见各接口附录
respMsg返回信息是见各接口附录
datadata 数据域是返回请求信息及我司订单号

data 数据域

子参描述是否必返说明
parMerCode主商户号是原样返回
merAcct商户账号是原样返回
productType产品类型是原样返回
transCode交易流水号否我司交易流水号（订单号）
userName姓名是
idNum证件号是

datarow 数据域

子参描述是否必返说明
score相似度分值是[0,600) 不同人；[600,700) 不确定；[700,1000] 同一人

应答示例

{
  "respCode": "PIDF00",
  "respMsg": "身份证号与姓名匹配，照片为同一人",
  "data": {
    "parMerCode": "主商户号",
    "merAcct": "商户账号",
    "productType": "PIDF",
    "transCode": "交易流水号",
    "userName": "姓名",
    "idNum": "证件号"
  },
  "datarow": {
    "score": "750"
  }
}

附录

产品类型字典

产品类型枚举值产品类型含义
PIDF身份证人脸比对

返回码及信息字典

返回码返回信息是否计费
PIDF00身份证号与姓名匹配，照片为同一人是
PIDF01身份证号与姓名匹配，照片不能确定为同一人是
PIDF02身份证号与姓名匹配，照片为不同人是
PIDF03身份证号与姓名不匹配是
PIDF04库中无此身份证号否
PIDF05照片质量不合格否
PIDF06身份证号与姓名匹配，库中无照片是
PIDF07身份证号与姓名匹配，照片检测失败是
ID身份证号有误是
NM姓名有误是
LM交易过于频繁或次数超限否
ER交易异常否
OT交易超时/资源方超时否
SE系统异常否
DE请求数据有误否
SF验签失败否
PD权限不足否
AR账户余额不足否

加签说明与完整调用 Demo 见通用约定。

公安实名二要素
通过姓名与身份证号码一致性进行身份核验。
运营商三要素
姓名、身份证号、手机号三要素核验。