接入文档
接口简介
本接口提供银联卡账户类型识别服务。通过传入银行卡号,系统返回该卡片对应的账户层级(如Ⅰ类、Ⅱ类或Ⅲ类户),帮助开发者区分全功能账户与限制功能账户。
适用场景
- 金融风控:在开户或转账前校验账户权限,防范违规交易。
- 业务分流:根据账户类型引导用户进行不同额度的充值或支付操作。
- 数据清洗:完善用户画像,标记有效的高权限银行账户。
请求与返回说明
- 请求方式:POST
- 核心参数:
bankcard(字符串,必填),需传入待查询的银联卡号。 - 返回结果:JSON格式。
success为true时,data.resultMsg字段包含具体类型描述(例如“Ⅰ类”),data.result为类型代码。
接入建议
- 请确保传入的卡号格式正确且为银联标准卡号。
- 建议在业务关键节点调用,并缓存查询结果以减少重复请求。
- 注意处理网络异常及非银联卡号的错误返回情况。
接入示例代码
提供 Shell、Python、Go、Java、PHP 等常见接入示例,便于直接接到现有项目里。
请求示例
{
"bankcard": ""
}响应示例
{
"msg": "成功",
"success": true,
"code": 200,
"data": {
"result": "1",
"orderNo": "202511282209035161761",
"resultMsg": "Ⅰ类"
}
}请求字段
以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 示例值 |
|---|---|---|
| type | string | object |
| properties | object | {...} |
| properties.bankcard | object | {...} |
| properties.bankcard.type | string | string |
| properties.bankcard.description | null | null |
| required | array | "bankcard" |
| required[] | string | bankcard |
响应字段
以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 示例值 |
|---|---|---|
| type | string | object |
| properties | object | {...} |
| properties.msg | object | {...} |
| properties.msg.type | string | string |
| properties.msg.example | string | 成功 |
| properties.success | object | {...} |
| properties.success.type | string | boolean |