2 查询认证接口
使用说明： 注册事物号接口可使用于章节服务介绍中的远程身份认证服务与远程身份银行卡认证服务中，具体使用步骤请参考远程身份银行卡认证服务的时序图。
注意事项： 本接口通过AES加密进行通信。
2.1 功能描述
服务使用过程中最后需要向服务器查询认证结果，此接口即用于查询最终认证结果。
2.2 接口路径
https://rra.tongfudun.com/api/txn/query
2.3 请求方式
POST(application/json)
2.4 提交参数（分为明文数据和明文加密后的数据）
构造的明文数据为：
| 参数 | 描述 | 必填 | 备注 |
|---|---|---|---|
| token | 事务号 | 是 | 注册事务号接口返回的参数 |
| payegisSecretRoute | 授权编码 | 否 | 1C:D9:E1:86:76:77:39:81:4E:23:34 |
[danger] 注意
当参数payegisSecretRoute有值时，必须为上表备注中的value，才会返回具体的data值，具体见2.5节.
构造的密文数据为：
| 参数 | 描述 | 备注 |
|---|---|---|
| data | 密文数据 |
2.5 返回参数（分为密文数据和密文解密后的数据）
返回的加密数据为：
| status | message | data |
|---|---|---|
| -100 | 加密数据，请解密后使用 | 密文 |
| 10031 | 签名校验失败 | |
| 10042 | 接口密钥通信失败，请联系管理员 | |
| 10044 | 加密异常，请联系管理员 |
-100状态下对应的密文解密后的数据：
| status | message | data |
|---|---|---|
| 0 | 实名认证成功 | 参数payegisSecretRoute值传输正确，才有data返回 |
| 1 | 实名认证失败（+具体的的错误编码） | 参数payegisSecretRoute值传输正确，才有data返回 |
| -1 | 参数异常 | |
| 10011 | 服务异常，请联系通付盾管理员 | |
| 10021 | 事务号不存在 | |
| 2 | 事务尚未结束 | 参数payegisSecretRoute值传输正确，才有data返回 |
| 10043 | appId异常，请联系管理员 |
其中status=0、1或2时，data的内容如下表
| 参数 | 描述 | 备注 |
|---|---|---|
| name | 身份证姓名 | |
| cid | 身份证号码 | |
| realImg | 活体检测实景图 | Base64编码 |
| texturedImg | 公安网纹图 | Base64编码 |
| IDCardImg | 身份证正面图 | Base64编码 |
| IDCardImgBack | 身份证反面图 | Base64编码 |
| bankcardNo | 银行卡号 | |
| bankName | 发卡行 | |
| bankCardType | 卡类型 | |
| bankCardImg | 银行卡正面图 | Base64编码 |
[danger] 注意
有进行远程身份银行卡认证时才有参数bankcardNo、bankName、bankCardType、bankCardImg的返回。
其中status=1时，具体的错误编码如下表
| 错误编码 |
|---|
| （1101身份证号码与姓名不一致） |
| （1102身份证号码与姓名一致，暂无网纹照片） |
| （1103无此身份证号码，请到户籍所在地进行核查） |
| （1104查询超时） |
| （1人脸比对不通过） |
| （10009人脸比对失败） |
| （1银行卡校验不通过） |
| （4099交易失败） |
| （4023此卡不支持此交易） |
| （4019密码错误次数超限） |
| （4018受限制的卡） |
| （4017该卡已过期） |
| （4016此卡已挂失） |
| （4015作弊卡，吞卡） |
| （4014此卡为初始卡或睡眠卡） |
| （4013此卡无对应发卡行） |
| （4012无效卡号） |
| （4009此卡被没收） |
| （4007未开通无卡支付） |
| （4006持卡人信息有误） |
| （4005数据校验不通过） |
| （4004手机号码不合法） |
| （4001姓名校验不通过） |
| （4003（E*）银行卡号码有误） |
| （4002身份证号码有误） |
| （4098认证未通过） |
| （10023事务超时） |
2.6 示例
- 请求参数示例
加密前的数据：
{
"token":"4f4b9eaa-e105-4991-8df1-4f4209cffb3a"
}
加密后的数据：
{
"data":"密文"
}
- 返回结果示例
{
"status":"-100",
"message":"加密数据，请解密后使用",
"data":{},
"aesData":"密文"
}__
返回密文解密后的数据：
{
"status":"0",
"message":"实名认证成功",
"data":{具体值}
}