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"}, }