文档中心 人脸核身 接入文档 独立 H5 接入 合作方后台上送身份信息

合作方后台上送身份信息

最近更新时间:2019-07-30 16:28:30

生成签名

准备步骤

  • 前置条件:请合作方确保 SIGN ticket 已经正常获取,获取方式请参见 SIGN ticket 获取
  • 合作方为人脸核身服务生成签名,需要具有下表中的参数:
参数 说明 来源
wbappid 请添加小助手微信 faceid001,进行线下对接获取。 腾讯云线下对接分配
orderNo 订单号,本次人脸核身合作伙伴上送的订单号,唯一标识 合作方自行分配
name 姓名 -
idNo 证件号码 -
userId 用户 ID,用户的唯一标识(不要带有特殊字符) 合作方自行分配
version 1.0.0 -
api ticket 合作伙伴服务端缓存的 tikcet,注意是 SIGN 类型 获取方式请参见 SIGN ticket 获取

注意:

参与签名的数据需要和该接口中的请求参数保持一致。

基本步骤

  1. 将 appId、orderNo、name、idNo、userId、version、ticket(SIGN 类型)共7个参数的值进行字典序排序。
  2. 将排序后的所有参数字符串拼接成一个字符串。
  3. 将排序后的字符串进行 SHA1 编码,编码后的40位字符串作为签名(sign)。

说明:

签名算法可参考 签名算法说明

参考示例

  • 请求参数:
    参数参数值
    webankAppIdappId001
    orderNoorderNo19959248596551
    nametestName
    idNo4300000000000
    userIduserID19959248596551
    version1.0.0
    ticketduSz9ptwyW1Xn7r6gYItxz3feMdJ8Na5x7JZuoxurE7RcI5TdwCE4KT2eEeNNDoe
  • 字典排序后的参数为:
    [1.0.0, 4300000000000, appId001, duSz9ptwyW1Xn7r6gYItxz3feMdJ8Na5x7JZuoxurE7RcI5TdwCE4KT2eEeNNDoe, orderNo19959248596551, testName, userID19959248596551]
  • 拼接后的字符串为:
    1.0.04300000000000appId001duSz9ptwyW1Xn7r6gYItxz3feMdJ8Na5x7JZuoxurE7RcI5TdwCE4KT2eEeNNDoeorderNo19959248596551testNameuserID19959248596551
  • 计算 SHA1 得到签名:
    该字符串就是最终生成的签名(40位),不区分大小写。
    EE57F7C1EDDE7B6BB0DFB54CD902836B8EB0575B

合作方后台上送身份信息

请求

  • 请求 URL:https://idasc.webank.com/api/server/h5/geth5faceid
  • 请求方法:POST
  • 报文格式:Content-Type: application/json
  • 请求参数:
    参数说明类型长度(字节)是否必填
    webankAppId 腾讯云线下对接分配的 AppID String 腾讯云线下对接决定
    orderNo 订单号,由合作方上送,每次唯一,不能超过32位 String 不能超过32位
    name 姓名 String -
    idNo 证件号码 String -
    userId 用户 ID ,用户的唯一标识(不能带有特殊字符) String -
    sourcePhotoStr 比对源照片,注意:原始图片不能超过500KB,且必须为 JPG 或 PNG 格式
    • 参数有值:使用合作伙伴提供的比对源照片进行比对,必须注照片是正脸可信照片,照片质量由合作方保证
    • 参数为空 :根据身份证号+姓名使用权威数据源比对
    Base64 String 1048576
    sourcePhotoType 比对源照片类型
    • 参数值为1:水纹正脸照
    • 参数值为2:高清正脸照
      String 1
      version 默认参数值为:1.0.0 String 20
      sign 签名:使用上文 生成的签名 String 40

    响应

    响应示例:

    {
        "code": 0,
        "msg": "成功",
        "result": {
            "bizSeqNo": "业务流水号",
            "orderNo": "合作方订单号",
            "h5faceId": "cc1184c3995c71a731357f9812aab988"
        }
    }