银行卡三要素

POST

https://data.4321.sh/factor/idcardvalid

银行卡三要素

银行卡三要素 API是飞鸽传书（上海）信息科技有限公司针对用户开放出的接口
采用 HTTP POST 请求模式，飞鸽传书API 该接口可以根据身份证、银行卡号和姓名获取到验证信息。

是否需要授权：是参阅 API 授权和验证机制

错误代码：参阅 API 错误代码

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://data.4321.sh/factor/idcardvalid' \
--header 'Content-Type: application/json' \
--data-raw '{
    "apikey": "string",
    "secret": "string",
    "name": "string",
    "id_card": "string",
    "bank_no": "string"
}'

响应示例

{
  "data": {
    "result": "01",
    "bank_name": "所属银行",
    "card_type": "银行卡类型",
    "card_category": "银行卡类别",
    "remark": "备注"
  },
  "fee": 0.2,
  "code": 0,
  "msg": "OK"
}

请求参数

Body 参数application/json

apikey

string

身份认证产品Api接口账号

可选

secret

string

身份认证产品Api接口秘钥

可选

name

string

姓名

可选

id_card

string

身份证号

可选

bank_no

string

银行卡号

可选

示例

返回响应

🟢200成功

application/json

Body

data

object

返回对象

必需

返回对象

result

string

返回结果 01-认证一致(收费) 02-认证不一致(收费) 03-认证不确定（不收费） 04-认证失败(不收费)

必需

bank_name

string

所属银行

必需

中国建设银行

card_type

string

银行卡类型

必需

龙卡通

card_category

string

银行卡类别

必需

借记卡

remark

string

备注

必需

验证通过

fee

number

认证费用

必需

0.2

code

integer

接口回执状态码，判断成功失败的标志

必需

成功为0，其它请参考 API 错误代码

msg

string

接口回执状态描述

必需

成功为OK，其它请参考 API 错误代码

银行卡四要素

银行卡二要素