账号实名认证信息比对 v2.4

1. 接口简介

• 用户实名认证信息检查，校验输入的身份证姓名和身份证号码是否与实名认证的信息匹配；敏感权限

  • odp 进行服务申请
    申请服务名：GACC 帐号相关服务（gacc_account_service）
    申请的接口：账号实名认证信息比对服务
    申请方式参考：内网文档
  • 申请注明：使用方业务名称 ，使用背景 ，使用范围 ，申请的 QPS 量级（建议 QPS：30）

注意：该接口在比对的过程中，会对输入的身份证信息再次进行征信校验，征信校验过程中会产生高额费用，请调用方注意，减少不必要的调用

2. L5 信息

• 正式环境：64620673:851968
• 测试环境：64620673:917504

3. 账号实名认证信息比对接口

CGI 基本信息

• 请求 URL：http://ip:port/dmfeature/4037/userCertIdCheck
• 接口请求方式：POST
• 接口返回数据格式：JSON

请求参数说明及完整示例

HEADER 参数

 签名计算方式：             lowercase(md5(strcat(destination,',',source,',',timestamp,',',nonce,',',secret)))
    destination为，
    source为,
    timestamp为当前服务器Unix秒，
    nonce为长度为6的随机字符串，
    secret为调用方自身服务秘钥

POST 参数

示例：
{
  "name": "张三",
  "certId": "11010020191010789X",
  "context": "blabla",
  "authInfo": {
    "authUserType": 3,
    "authAppid": "1234567",
    "authUserId": "24347382",
    "authKey": "244fe73ab2343803ce"
  },
  "device": {
    "outerIp": "14.17.22.35",
    "osSystem": "windows"
  }
}

完整请求示例：
curl -H "X-Odp-Destination-Service:gacc_account_service" -H "X-Odp-Source-Service:xxx" -H "X-Odp-Timestamp:xxx" -H "X-Odp-Nonce:xxx" -H "X-Odp-Signature:xxx" -d '{"name": "张三","certId": "11010020191010789X","context": "blabla","authInfo": {"authUserType": 3,"authAppid": "","authUserId": "24347382","authKey": "244fe73ab2343803ce"},"device": {"outerIp": "14.17.22.35", "osSystem": "windows"}}' "http://ip:port/dmfeature/4037/userCertIdCheck"

返回字段说明及返回结果示例

返回参数

返回结果：
{
  "ret": 0,
  "msg": "",
  "context": "blabla",
  "traceId": "hp95a3a4d7c627e07d-3-24347382-24347382-837",
  "isMatch": 1,
  "isCert": 1
}

4. 返回码说明

鉴权信息 AuthInfo

• 对于帐号体系互通的登录行为，还需要额外字段用于鉴权 authInfo。
• 对于 wegame 里 qq 登录的，获取票据的方式，参考下面的样例代码。
• wegame 在即通的 authAppid 请联系 wegame 同事查询，每个游戏都不一样。

从 wegame 的 tcls sdk 中获取 ST 的方式

BYTE byarrGameSignature[QQLO_GAMESIGNMAXLEN] = {0};
    nTmp = sizeof(byarrGameSignature);
    bSucess = m_pTclsProxy->GetBYTE(SM_BYTE_GAMESIGNATURE_SIGNATURE, byarrGameSignature, &nTmp);

设备 Device

• 游戏后台上报设备信息，在管理端可以配置设备属性相关的规则。
• 规则按地区灰度时，需要知道用户设备的外网 ip 或经纬度信息。
• 当有人脸规则时，部分操作系统或手机型号暂不支持时，不下发此类决策。
• 这里填写的全是用户使用的客户端的信息，不是服务器的信息。

5. 接口常见问题 Q&A

1.账号实名信息说明

账号实名信息：指用于登录游戏的 QQ 或者微信账号的实名认证信息，每一个 QQ/微信账号对应的实名信息唯一。实名认证信息可能是：

• 用户 QQ 支付/微信支付绑定的实名信息
• 用户登录游戏引导进行实名认证的信息

• QQ 账号实名注册信息

  2.输入的 authInfo 作用

• 输入的 authInfo 用于查询对应 QQ/微信账号的实名认证信息

• 如果输入参数不对（通常如 appid 和 openid 不匹配，accessToken 过期等）或者微信 appid 没有查询对应微信账号实名信息的权限，均会导致中控查询账号实名认证信息失败

• 如果中控不能查询到实名认证信息便不能进行实名信息比对

  3.什么情况下比对成功

• 输入的 name 和 certId 必须是合法的身份证姓名和身份证号码

• 输入的 name 和 certId 和账号实名信息使用的身份证姓名和身份证号码完全一致

  4.已实名认证，不匹配情况：

• 检查输入的姓名和身份证号，是否和实名认证用的证件信息完全一致，务必确认清楚

• 部分非常早期的用户，实名认证时候，是没有校验身份证号的，所以存在误填的可能，确认早期是否实名注册时随便填了身份证号

特别说明:

1. 对 QQ 用户，如果在较早时期对自己账号进行过实名注册操作，如果自己随意输入的身份证号，请联系客服处理
2. 部分 QQ 号返回的实名信息可能是 QQ 绑定的微信账号认证的实名信息。 用户的实名状态以https://jiazhang.qq.com/zk/home.html上查询到的状态为准