银行卡账户类型查询比对

根据银行卡号查询账户类型，或与指定类型比对。

产品概述

根据银行卡号查询账户类型；也可根据银行卡号 + 需要比对的账户类型查询是否验证一致。

接口说明

  • 请求地址：由服务方提供
  • 请求方式：HTTP POST
  • 请求格式：application/x-www-form-urlencoded
  • 响应格式：application/json
  • 超时时间：默认 20s

请求参数

参数描述是否必填说明
parMerCode主商户号是商户一级账号，由服务方提供
merAcct商户账号是商户二级账号，由服务方提供
appKey商户密钥否加签所需密钥，由服务方提供，入参不传此值
signature签名值是报文加签后的值，见通用约定
productType产品类型是见各接口附录
merserialNo商户流水号否最长 36 位，建议上送便于双方查询交易
version版本号否返回银行卡类型传 1.1
bankNumber银行卡号是
userName姓名否
idNum身份证号否
phoneNum手机号否
accountType账户类型否不送直接返回类型，上送返回比对结果

请求示例

{"accountType":"1","phoneNum":"13800138000","idNum":"身份证号","merAcct":"XXX_A","userName":"张三","merserialNo":"129491597923","parMerCode":"XXX","signature":"3c8daf6c61495e45f960bde3414d4201","productType":"PAT5","bankNumber":"6222..."}

响应参数

参数描述是否必返说明
respCode返回码是见各接口附录
respMsg返回信息是见各接口附录
datadata 数据域是返回请求信息及我司订单号

data 数据域

子参描述是否必返说明
parMerCode主商户号是原样返回
merAcct商户账号是原样返回
productType产品类型是原样返回
transCode交易流水号否我司交易流水号（订单号）
bankNumber银行卡号是原样返回
userName姓名否
idNum身份证号否
phoneNum手机号否
accountType账户类型否原样返回（若上送）

datarow 数据域

子参描述是否必返说明
bankName银行名称否获取成功后返回
type账户类型否不上送 accountType 时通过该字段获取

应答示例

{"respCode":"PAT05","respMsg":"不支持的银行","data":{"phoneNum":"13800138000","idNum":"身份证号","accountType":"1","userName":"张三","merAcct":"XXX_A","bankName":"XX银行","parMerCode":"XXX","transCode":"MA87520200715202147758","productType":"PAT5","bankNumber":"6222..."}}

返回类型的返回码：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账户余额不足否
TNS该产品服务暂不可用否

账户类型字典

枚举值含义
1比较是否是一类户
2比较是否是二类户
3比较是否是三类户

加签说明与 Java Demo 见通用约定。

银行卡二三四要素-非身份证
支持非身份证证件类型的银行卡身份核验。
银行卡账户类型查询
根据银行卡号查询账户类型。