银行卡账户类型查询

根据银行卡号查询账户类型。

产品概述

根据银行卡号查询账户类型。

接口说明

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

请求参数

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

请求示例

POST 请求体为 application/x-www-form-urlencoded(非 JSON),appKey 不入参。Body 示例:

parMerCode=主商户号&merAcct=商户账号&productType=PAT5&merserialNo=商户流水号&bankNumber=6225888888888888&userName=张三&idNum=身份证号&phoneNum=13800138000&signature=加签后的签名值

响应参数

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

data 数据域

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

应答示例

{
  "respCode": "PAT01",
  "respMsg": "一类银行账户",
  "data": {
    "parMerCode": "主商户号",
    "merAcct": "商户账号",
    "productType": "PAT5",
    "transCode": "交易流水号",
    "bankNumber": "银行卡号",
    "userName": "姓名",
    "idNum": "身份证号",
    "phoneNum": "手机号",
    "bankName": "银行名称"
  }
}

附录

产品类型字典

产品类型枚举值产品类型含义
PAT5账户类型查询

返回码及信息字典

返回码返回信息是否计费
PAT01一类银行账户是
PAT02二类银行账户是
PAT03三类银行账户是
PAT23二类或三类银行账户是
PAT05暂不支持的银行否
PAT06未知账户类型否
PAT07非电子账户是
PAT08贷记卡否
LM交易次数超限或操作过频否
CD银行卡号码有误是
SJ手机号码不合法是
ID身份证号错误是
NM姓名不合法是
AT账户类型错误否
ER交易异常否
OT交易超时/资源方超时否
SE系统异常否
DE请求数据有误否
SF验签失败否
PD权限不足否
AR账户余额不足否

加签说明与完整调用 Demo 见通用约定。