银行卡二三四要素-身份证
通过姓名、身份证号、手机号、银行卡号进行银联卡身份核验。
产品概述
通过客户姓名、身份证号码、柜面预留手机号码、银行卡号的一致性来进行银行卡身份核验。
覆盖范围：银联卡（部分银行需要开通银联在线支付）。
银行卡号（bankNumber）必送，其他请求参数至少提供一个。四参数齐全为四要素；三要素支持卡号+身份证号+姓名；二要素支持卡号+身份证号、卡号+姓名、卡号+手机号。
- 响应时间：平均 500ms
接口说明
- 请求地址：由服务方提供
- 请求方式：HTTP POST
- 请求格式：
application/x-www-form-urlencoded - 响应格式：
application/json - 超时时间：默认 20s
请求参数
| 参数 | 描述 | 是否必填 | 说明 |
|---|---|---|---|
| parMerCode | 主商户号 | 是 | 商户一级账号，由服务方提供 |
| merAcct | 商户账号 | 是 | 商户二级账号，由服务方提供 |
| appKey | 商户密钥 | 否 | 加签所需密钥，由服务方提供，入参不传此值 |
| signature | 签名值 | 是 | 报文加签后的值，见通用约定 |
| productType | 产品类型 | 是 | 见各接口附录 |
| merserialNo | 商户流水号 | 否 | 最长 36 位，建议上送便于双方查询交易 |
| version | 版本号 | 否 | 要返回银行卡类型传值 1.1，否则无需上传 |
| bankNumber | 卡号 | 是 | 银行卡号 |
| userName | 姓名 | 否 | 银行卡开户预留姓名 |
| idNum | 证件号 | 否 | 银行卡开户预留证件号 |
| phoneNum | 手机号 | 否 | 银行卡开户预留手机号 |
| isPersonalAuth | 是否取得个人授权 | 是 | 1-是 0-否 |
| busiScene | 业务场景 | 是 | 1-绑卡类实名认证 2-关联支付时核验 |
请求示例
响应参数
| 参数 | 描述 | 是否必返 | 说明 |
|---|---|---|---|
| respCode | 返回码 | 是 | 见各接口附录 |
| respMsg | 返回信息 | 是 | 见各接口附录 |
| data | data 数据域 | 是 | 返回请求信息及我司订单号 |
data 数据域
| 子参 | 描述 | 是否必返 | 说明 |
|---|---|---|---|
| parMerCode | 主商户号 | 是 | 原样返回 |
| merAcct | 商户账号 | 是 | 原样返回 |
| productType | 产品类型 | 是 | 原样返回 |
| transCode | 交易流水号 | 否 | 我司交易流水号（订单号） |
| bankName | 银行名称 | 是 | 返回银行卡对应银行名称 |
| bankNumber | 卡号 | 是 | 原样返回 |
| userName | 姓名 | 否 | 原样返回 |
| idNum | 证件号 | 否 | 原样返回 |
| phoneNum | 手机号 | 否 | 原样返回 |
datarow 数据域（version=1.1 时返回）
| 子参 | 描述 | 是否必返 | 说明 |
|---|---|---|---|
| CardType | 银行卡类型 | 否 | 见附录银行卡类型字典 |
应答示例
根据上送的要素个数选择对应 productType，三四要素产品类型相同，二要素需一一对应。
附录
产品类型字典
| 产品类型枚举值 | 产品类型含义 |
|---|---|
| PB02 | 银行卡二要素（卡号+姓名） |
| PB021 | 银行卡二要素（卡号+手机号） |
| PB022 | 银行卡二要素（卡号+身份证号） |
| PB03 | 银行卡三要素（卡号+姓名+身份证号） |
| PB34 | 银行卡四要素（卡号+姓名+身份证号+手机号） |
返回码及信息字典
| 返回码 | 返回信息 | 是否计费 |
|---|---|---|
| 00 | 认证一致，成功 | 是 |
| 01 | 发卡行不支持此笔交易 | 否 |
| 03 | 认证不一致，发卡行不支持此笔交易 | 是 |
| 04 | 认证不一致，此卡被没收 | 是 |
| 05 | 认证不一致，持卡人信息有误 | 是 |
| 06 | 认证不一致，认证未通过请联系发卡行 | 是 |
| 14 | 认证不一致，无效卡号 | 是 |
| 15 | 认证不一致，此卡无对应发卡行 | 是 |
| 21 | 认证不一致，该卡未初始化或睡眠卡 | 是 |
| 28 | 认证不一致，当前提交数量过多 | 否 |
| 33 | 认证不一致，此卡已过期 | 是 |
| 34 | 认证不一致，作弊卡、吞卡 | 是 |
| 35 | 认证不一致，卡状态异常 | 是 |
| 36 | 认证不一致，受限制的卡 | 是 |
| 40 | 认证不一致，未开通无卡支付 | 是 |
| 41 | 认证不一致，此卡已挂失 | 是 |
| 42 | 认证不一致，无此账户 | 是 |
| 43 | 认证不一致，被窃卡 | 是 |
| 54 | 认证不一致，此卡已过期 | 是 |
| 62 | 认证不一致，受限制的卡 | 是 |
| 65 | 认证不一致，认证未通过请联系发卡行 | 是 |
| 67 | 无法验证 | 否 |
| 75 | 认证不一致，密码错误次数超限 | 是 |
| IL | 认证不一致，无法识别的卡 | 是 |
| LM | 交易次数超限或操作过频 | 否 |
| MP | 您的银行卡未预留手机号 | 是 |
| CT | 无效证件类型 | 否 |
| ID | 认证不一致，身份证号错误 | 是 |
| NM | 认证不一致，姓名校验不通过 | 是 |
| CD | 认证不一致，银行卡号码有误 | 是 |
| SJ | 认证不一致，手机号码不合法 | 是 |
| NS | 该卡暂不支持认证 | 否 |
| MN | 交易商户名称不合法 | 否 |
| TS | 交易场景代码不合法 | 否 |
| ER | 交易异常 | 否 |
| OT | 交易超时/资源方超时 | 否 |
| SE | 系统异常 | 否 |
| DE | 请求数据有误 | 否 |
| SF | 验签失败 | 否 |
| PD | 权限不足 | 否 |
| AR | 账户余额不足 | 否 |
| TNS | 该产品服务暂不可用 | 否 |
银行卡类型字典
| 枚举值 | 含义 |
|---|---|
| 1 | 借记卡 |
| 2 | 贷记卡 |
| 3 | 准贷记卡 |
| 4 | 预付费卡 |
加签说明与 Java Demo 见通用约定。