运营商三要素

姓名、身份证号、手机号三要素核验。

产品概述

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

接口说明

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

请求参数

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

请求示例

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

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

响应参数

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

data 数据域

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

datarow 数据域

子参描述是否必返说明
phoneType运营商类型是见附录运营商类型字典

应答示例

{
  "respCode": "P300",
  "respMsg": "认证一致，成功",
  "data": {
    "parMerCode": "主商户号",
    "merAcct": "商户账号",
    "productType": "PT3",
    "transCode": "交易流水号",
    "userName": "姓名",
    "idNum": "证件号",
    "phoneNum": "手机号"
  },
  "datarow": {
    "phoneType": "1"
  }
}

附录

产品类型字典

产品类型枚举值产品类型含义
PT3运营商三要素

返回码及信息字典

返回码返回信息是否计费
P300认证一致，成功是
P301认证不一致，三要素信息不一致是
P302交易异常否
P303不存在否
P304无法验证否
ID身份证号码不正确是
NM姓名不正确是
SJ手机号码不正确是
ER交易异常否
OT交易超时/资源方超时否
SE系统异常否
DE请求数据有误否
SF验签失败否
PD权限不足否
AR账户余额不足否

运营商类型字典

枚举值含义
1联通
2移动
3电信
4广电
9未知

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

身份证人脸比对
通过姓名、身份证号、人脸照片三者一致性进行身份核验。
产品类型字典
全部产品 productType 枚举汇总。