公安实名二要素

通过姓名与身份证号码一致性进行身份核验。

产品概述

通过姓名、身份证号码的一致性来进行身份核验。

  • 响应时间：平均 300ms

接口说明

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

请求参数

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

请求示例

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

parMerCode=主商户号&merAcct=商户账号&productType=PI1&merserialNo=商户流水号&userName=张三&idNum=身份证号&signature=加签后的签名值

响应参数

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

data 数据域

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

应答示例

{
  "respCode": "PI00",
  "respMsg": "认证一致，成功",
  "data": {
    "parMerCode": "主商户号",
    "merAcct": "商户账号",
    "productType": "PI1",
    "transCode": "交易流水号",
    "userName": "姓名",
    "idNum": "证件号"
  }
}

附录

产品类型字典

产品类型枚举值产品类型含义
PI1公安实名二要素认证

返回码及信息字典

返回码返回信息是否计费
PI00认证一致，成功是
PI01认证不一致是
PI02交易异常否
PI03库无（公安查无）否
ID认证不一致，身份证号错误是
NM认证不一致，姓名校验不通过是
ER交易异常否
OT交易超时/资源方超时否
SE系统异常否
DE请求数据有误否
SF验签失败否
PD权限不足否
AR账户余额不足否

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

银行卡归属地查询
根据银行卡号查询归属地（发卡行名称&卡组织编码&bin长度&完整卡号长度&卡大类&卡细类）。
身份证人脸比对
通过姓名、身份证号、人脸照片三者一致性进行身份核验。