银行卡账户类型查询比对
根据银行卡号查询账户类型，或与指定类型比对。
产品概述
根据银行卡号查询账户类型；也可根据银行卡号 + 需要比对的账户类型查询是否验证一致。
接口说明
- 请求地址：由服务方提供
- 请求方式：HTTP POST
- 请求格式：
application/x-www-form-urlencoded - 响应格式：
application/json - 超时时间：默认 10s
请求参数
| 参数 | 描述 | 是否必填 | 说明 |
|---|---|---|---|
| parMerCode | 主商户号 | 是 | 商户一级账号，由服务方提供 |
| merAcct | 商户账号 | 是 | 商户二级账号，由服务方提供 |
| appKey | 商户密钥 | 否 | 加签所需密钥，由服务方提供，入参不传此值 |
| productType | 产品类型 | 是 | 见各接口附录 |
| merserialNo | 商户流水号 | 否 | 最长 36 位，建议上送便于双方查询交易 |
| signature | 签名值 | 是 | 报文加签后的值，见通用约定 |
| version | 版本号 | 否 | 返回银行卡类型传 1.1 |
| bankNumber | 银行卡号 | 是 | |
| userName | 姓名 | 否 | |
| idNum | 身份证号 | 否 | |
| phoneNum | 手机号 | 否 | |
| accountType | 账户类型 | 否 | 不送直接返回类型，上送返回比对结果 |
请求示例
POST 请求体为 application/x-www-form-urlencoded（非 JSON），appKey 不入参。Body 示例：
响应参数
| 参数 | 描述 | 是否必返 | 说明 |
|---|---|---|---|
| respCode | 返回码 | 是 | 见各接口附录 |
| respMsg | 返回信息 | 是 | 见各接口附录 |
| data | data 数据域 | 是 | 返回请求信息及我司订单号 |
data 数据域
| 子参 | 描述 | 是否必返 | 说明 |
|---|---|---|---|
| parMerCode | 主商户号 | 是 | 原样返回 |
| merAcct | 商户账号 | 是 | 原样返回 |
| productType | 产品类型 | 是 | 原样返回 |
| transCode | 交易流水号 | 否 | 我司交易流水号（订单号） |
| bankNumber | 银行卡号 | 是 | 原样返回 |
| userName | 姓名 | 否 | |
| idNum | 身份证号 | 否 | |
| phoneNum | 手机号 | 否 | |
| accountType | 账户类型 | 否 | 原样返回（若上送） |
datarow 数据域
| 子参 | 描述 | 是否必返 | 说明 |
|---|---|---|---|
| bankName | 银行名称 | 否 | 获取成功后返回 |
| type | 账户类型 | 否 | 不上送 accountType 时通过该字段获取 |
应答示例
返回类型的返回码：PAT01、PAT02、PAT03、PAT23、PAT05、PAT06、PAT07、PAT08。返回比对结果的返回码：PAT00、PAT10、PAT05、PAT06、PAT07、PAT08。
附录
产品类型字典
| 产品类型枚举值 | 产品类型含义 |
|---|---|
| PAT5 | 账户类型查询比对 |
返回码及信息字典
| 返回码 | 返回信息 | 是否计费 |
|---|---|---|
| PAT00 | 账户类型验证通过 | 是 |
| PAT10 | 账户类型验证不通过 | 是 |
| PAT01 | 一类银行账户 | 是 |
| PAT02 | 二类银行账户 | 是 |
| PAT03 | 三类银行账户 | 是 |
| PAT23 | 二类或三类银行账户 | 是 |
| PAT05 | 暂不支持的银行 | 否 |
| PAT06 | 未知账户类型 | 否 |
| PAT07 | 非电子账户 | 是 |
| PAT08 | 贷记卡 | 否 |
| LM | 交易次数超限或操作过频 | 否 |
| CD | 银行卡号码有误 | 是 |
| SJ | 手机号码不合法 | 是 |
| ID | 身份证号错误 | 是 |
| NM | 姓名不合法 | 是 |
| AT | 账户类型错误 | 否 |
| ER | 交易异常 | 否 |
| OT | 交易超时/资源方超时 | 否 |
| SE | 系统异常 | 否 |
| DE | 请求数据有误 | 否 |
| SF | 验签失败 | 否 |
| PD | 权限不足 | 否 |
| AR | 账户余额不足 | 否 |
账户类型字典
| 枚举值 | 含义 |
|---|---|
| 1 | 比较是否是一类户 |
| 2 | 比较是否是二类户 |
| 3 | 比较是否是三类户 |
加签说明与完整调用 Demo 见通用约定。