5 银行卡四要素校验接口

  使用说明:   银行卡四要素校验接口可使用于章节服务介绍中的银行卡四要素校验服务中,具体使用步骤请参考银行卡四要素校验服务的时序图。

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

5.1 功能描述

  此接口用于核实输入的银行卡号与姓名、身份证号码与手机号码(银行卡四要素)这四者是否匹配、是否真实有效。

5.2 接口路径

https://rra.tongfudun.com/func/bankcard/verifyfour

5.3 请求方式

POST(application/json)

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

  构造的明文数据为:

参数 描述 备注
name 身份证姓名 必填
cid 身份证号码 必填
cardno 银行卡号码 必填
phone 手机号码 必填

  构造的密文数据为:

参数 描述 备注
data 密文数据

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

  返回的加密数据为:

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

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

status message data
0 身份证银行卡校验通过
-1 参数异常
10011 服务异常,请联系通付盾管理员
10032 该服务尚未开通
10033 服务欠费,请充值
4098 认证未通过
4001 姓名校验不通过
4002 身份证号码有误
4003 (E*)银行卡号码有误
4004 手机号码不合法
4005 数据校验不通过
4006 持卡人信息有误
4007 未开通无卡支付
4009 此卡被没收
4012 无效卡号
4013 此卡无对应发卡行
4014 此卡为初始卡或睡眠卡
4015 作弊卡,吞卡
4016 此卡已挂失
4017 该卡已过期
4018 受限制的卡
4019 密码错误次数超限
4023 此卡不支持此交易
4099 交易失败

5.6 示例

  • 请求参数示例

    加密前的数据: { "name":"张三", "cid":"13xxxxxxxxxxxxxxxxx", "cardno":"15xxxxxxxxxxxx", } 加密后的数据: { "data":"密文" }
  • 返回结果示例

    { "status":"-100", "message":"加密数据,请解密后使用", "data":{}, "aesData":"密文" } 返回密文解密后的数据: { "status":"0", "message":"身份证银行卡校验通过", "data":{} }

5.7 接口调用权限

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

results matching ""

    No results matching ""

    results matching ""

      No results matching ""