文档中心 > 银行卡二三四要素验证
银行卡二三四要素验证

最近更新时间:2021-10-14

1 功能描述

基于您的授权,快速验证开卡人银行卡卡号、身份证号码、姓名、手机号是否一致。

2 请求说明

2.1 请求方式

调用地址:https://apim.unicloud.com/api/ocr/bankcardauth/1.0.0/

请求方式:GET

返回类型:JSON

2.2 请求参数

Header如下:

参数说明
Content-Typeapplication/json--
AuthorizationBearer参考Token获取

Params如下:

参数是否必选类型可选值范围说明
transcodetruestring--105:二要素(银行卡号+姓名)
106:三要素(银行卡号+姓名+身份证号)
107:四要素(银行卡号+姓名+身份证号+手机号)
bankcardtruestring--银行卡号
usernametruestring--姓名
idcardfalsestring--身份证号(如果是三要素或四要素验证,该字段必选)
mobilefalsestring--手机号(如果是四要素验证,该字段必选)

注:Body无内容。

2.3 请求示例

curl -k -H "Authorization:Bearer 2735fbc9-b797-31ad-812c-d8e9e903f6e3" \ -d "idcard=120101111111111111&username=zhangsan&transcode=107&mobile=13000000000&bankcard=6212000000000000" \ https://apim.unicloud.com/api/ocr/bankcardauth/1.0.0/

3 返回说明

3.1 返回参数

字段类型说明
msgstring信息描述
dataobject返回结果数据
+platformCodestring返回码001000000:验证通过,001010034:验证信息不一致
+platformDescstring返回信息
+transcodestring105:二要素(银行卡号+姓名)
106:三要素(银行卡号+身份证号+姓名)
107:四要素(银行卡号+身份证号+姓名+手机号)
codestring平台返回编号20050:成功,30001:失败

3.2 返回示例

{         "msg": "成功并计费",      "data": {                     "platformDesc": "验证通过",                     "platformCode": "001000000",                     "transcode":"105"     },         "code": "20050"    //这里返回20050计费,30001不计费 }