1 注册事务号接口

  使用说明:   注册事物号接口可使用于章节服务介绍中的远程身份认证服务、远程身份银行卡(三要素)认证服务与远程身份银行卡(四要素)认证服务中,具体使用步骤请参考远程身份银行卡(四要素)认证服务的时序图。

  注意事项:   本接口通过AES加密进行通信。

1.1 功能描述

  服务使用时需要首先向服务器申请事物号,并将事物号传递给SDK中的接口,才可以使用SDK功能,此接口即用于申请事物号。

  服务使用完成后,需要调用查询认证结果接口查看认证结果,此时需要传递事物号。

1.2 接口路径

https://rra.tongfudun.com/api/txn/register

1.3 请求方式

POST(application/json)

1.4 提交参数(分为明文数据和明文加密后的数据)

  构造的明文数据为:

参数 描述 备注
txntype 事务类型 NAME_ID,NAME_ID_BANKCARD,NAME_ID_BANKCARD_PHONE

[danger] 注意

NAME_ID为姓名和身份证校验模式;NAME_ID_BANKCARD为姓名、身份证和银行卡校验模式;NAME_ID_BANKCARD_PHONE为姓名、身份证、银行卡与手机号码校验模式

  构造的密文数据为:

参数 描述 备注
data 密文数据

1.5 返回参数(分为密文数据和密文解密后的数据)

  返回的加密数据为:

status message data
-100 加密数据,请解密后使用 密文
10031 签名校验失败
10042 接口密钥通信失败,请联系管理员
10044 加密异常,请联系管理员

  -100状态下对应的密文解密后的数据为:

status message data
0 申请事务号成功 token
-1 参数异常
10011 服务异常,请联系通付盾管理员
1 申请事务号失败
10032 该服务尚未开通
10033 服务欠费,请充值

1.6 示例

  • 请求参数示例

    加密前的数据: { "txntype":"NAME_ID" } 加密后的数据: { "data":"密文" }
  • 返回结果示例

    { "status":"-100", "message":"加密数据,请解密后使用", "data":{}, "aesData":"密文" } 返回密文解密后的数据: { "status":"0", "message":"申请事务号成功", "data":{"token":"131455xxxxxxxxxxxx"}, }

1.7 接口调用权限

  详情参考AES加解密章节与接口调用鉴权章节内容。

results matching ""

    No results matching ""

    results matching ""

      No results matching ""