CFCA-云证通

CFCA-云证通

模块名称

  • cfcaHKE

模块引入

  • Weex

const cfcaHKE = app.requireModule("cfcaHKE");

  • H5

let cfcaHKE = requireModuleJs('cfcaHKE');

模块方法

  • getRandomStr(params, callBack)

    • 获取随机数

    • 参数说明 params为json字符串

      参数 说明 类型
      name 姓名 String
      type 证件类型 “0”为身份证 String
      idnum 证件号码 String
      mobile 手机号 String
      deviceID 手机设备id String
      encryptedSensitiveKey 秘钥，根据项目方案来决定是否启用密钥，不用的话值默认为"" String
      authInfo 意思就是userIndentity，值默认为"" String
      orgID 机构码， SDK厂商分配 String
      appID app码， SDK厂商分配 String
      serviceType 服务器类型，值为三种:“0"代表生产,“1"代表test,“2"代表debug String

    • 返参说明 回调返回数据是json字符串

      • 错误时返回字段：type //“0” 失败 msg // 错误描述字符串

      • 成功时返回字段：type //“1” 成功 serverRandom //随机数

  • auth(randomSignature, callBack)

    • 身份认证
    • 入参说明：入参randomSignature //随机数签名，即机构服务器用机构证书对随机数的签名。
    • 回调说明：回调数据是json字符串。
      • 错误回调返回字段：type //“0” 失败 msg // 错误描述字符串
      • 成功回调， 有两种情况： 
        1）有证书的情况，返回：
    type  //"1"  成功
    state  //  写死“1”, 表示本地有证书
    PinState  // API返回的PIN状态码，string形式
    msg   // 值写死“本地有证书"

2）无证书的情况，
    type  //"1"  成功
    state  //  写死“2”, 表示需下载证书
    PinState  // API返回的PIN状态码，string形式
    msg   //描述信息，值："没有证书请下载”或"证书已过期请重新下载”或"本地证书已失效请重新下载"

  • downloadCertificate(callBack)

    • 证书说明
    • 回调说明：回调数据是json字符串
      • 错误回调返回字段：type //“0” 失败 msg // 错误描述字符串
      • 成功回调返回字段： 
        type  //"1"  成功
msg  //描述信息， 值："证书下载成功"
CertSn  //证书序列号
CertApplyDate //证书申请日期，日期格式  yyyy-MM-dd HH:mm:ss
CertEndDate  //证书到期日期

  • doSign(params, callBack)

    • 业务签名（无PIN码）

    • 入参说明：

      参数 说明 类型
      orgContent 签名原文 //符合云证通要求拼装的JSON字符串。签名原文是在机构服务器（银行服务器）上完成拼装的 String
      signValue 签名结果 //银行服务器将拼装的JSON原文发往云证通服务器得到的签名结果，再下发给客户端 String

    • 回调说明：

      • 错误回调返回字段：type //“0” 失败 msg // 错误描述字符串
      • 成功回调返回字段：type //“1” 成功 msg //签名结果（JSON形式的签名原文里的businessText字段值是真正的业务原文， SDK这里就是对这个businessText字段值进行签名的结果）