2117-银行卡三要素验证（含业务和卡BIN）
1. 接口功能
根据姓名、身份证和银行卡号以及使用场景等信息来验证个人身份，并返回卡类型、发卡行信息。
- ScName终端商户名称：填写机构方公司名称；
- ScUsageScenarios使用场景：使用接口的具体APP或网站等场景，如，“某某APP”，“某某网站”；
- ScUsePurpose使用目的：具体机构方验证时的使用目的，如，“银行卡绑卡核验”，“身份信息核实”、“实名认证”等；
- ProtocolVerNm授权协议版本号：客户签署授权机构方使用其个人信息的电子协议名称以及版本号，如“xxx协议Ver1.0”“xxx协议Ver2.0”；
- SerialNm授权流水号：客户签署电子协议产生的流水号，要能够定位到具体签署协议时间，如，“20200315223013234”20200315为年月日，2230为时间（小时、分钟），234（毫秒），根据机构方具体情况而定；
2. 报文结构
请求报文：
| 报文元素 | 出现要求 | 非空约束 | 数据格式 | 说明 |
|---|---|---|---|---|
| TxCode | R | NOT NULL | N1..4 | 交易类型 |
| InstitutionID | R | NOT NULL | ANS1..8 | 机构编号 |
| TxSN | R | NOT NULL | ANS1..32 | 交易流水号 |
| Name | R | NOT NULL | ANS1..50 | 姓名 |
| IdentificationType | R | NOT NULL | AN1 | 证件类型 0=身份证 2=护照 3=军官证 4=士兵证 5=港澳居民来往内地通行证 6=台湾同胞来往内地通行证 9=警官证 R=居住证 X=其他证件 |
| IdentificationNumber | R | NOT NULL | N1..32 | 证件号码 |
| AccountNumber | R | NOT NULL | N1..32 | 银行卡号 |
| Remark | O | ANS0..256 | 备注 | |
| TransCode | R | NOT NULL | N2 | 交易场景编码 01 = 直销银行 02 = 消费金融 03 银行二三类账户开户 04 = 征信 05 = 保险 06 = 基金 07 = 证券 08 = 租赁 09 = 海关申报 99 = 其他 |
| ScName | R | NOT NULL | ANS1..40 | 终端商户名称 |
| ScUsageScenarios | R | NOT NULL | ANS1..40 | 终端商户产品的使用场景 |
| ScUsePurpose | R | NOT NULL | ANS1..128 | 终端商户的使用目的 |
| ProtocolVerNm | R | NOT NULL | ANS1..128 | 终端商户与C端客户签订的电子协议版本号 |
| SerialNm | R | NOT NULL | ANS1..64 | C端客户向终端商户进行信息核验（或查询）的授权流水号 |
响应报文：
| 报文元素 | 出现要求 | 非空约束 | 数据格式 | 说明 |
|---|---|---|---|---|
| Code | R | NOT NULL | N1..6 | 响应代码 |
| Message | R | NOT NULL | ANS1..256 | 响应消息 |
| TxCode | C | NOT NULL | ANS1..4 | 交易类型 |
| InstitutionID | C | NOT NULL | ANS1..8 | 机构号 |
| TxSN | C | NOT NULL | ANS1..32 | 交易流水号 |
| TraceNo | C | NOT NULL | ANS1..32 | 交易跟踪号 |
| BankID | C | NOT NULL | AN0..8 | 发卡行编码 |
| CardType | C | NOT NULL | N0..2 | 卡类型 01=借记卡 02=贷记卡 03=预付费卡 04=准贷记卡 |
| Verification | C | NOT NULL | N2 | 验证状态 10=未知 20=匹配 30=不匹配 |
| ResponseCode | C | N0..4 | 通道响应代码 | |
| ResponseMessage | C | ANS0..256 | 通道响应消息 |
3.报文样例：
[!TIP] （测试数据不校验数据真实性，默认为验证结果为匹配，若验证其他结果，可查看“总体规范-6.1.2.4 Remark 备注”）
请求报文(InstitutionID由中金分配)：
{
"ScName":"测试",
"TxCode":"2117",
"IdentificationNumber":"430522199209122671",
"ProtocolVerNm":"tls1.0",
"InstitutionID":"XXXXXX",
"SerialNm":"20221123",
"IdentificationType":"0",
"Name":"王测试",
"AccountNumber":"6216615300014634559",
"Remark":"",
"ScUsePurpose":"测试",
"TransCode":"01",
"TxSN":"202211231609458092408536443",
"ScUsageScenarios":"测试"
}
响应报文：
{
"ResponseCode":"0000",
"TxCode":"2117",
"Message":"SUCCESS",
"InstitutionID":"XXXXXX",
"CardType":"01",
"TxSN":"202211231609458092408536443",
"Verification":"20",
"ResponseMessage":"匹配",
"BankID":"104",
"Code":"2000",
"TraceNo":"2211231610303811112017164"
}
该文档未解决您的疑问？
查看常见问题