1.文档说明

1.1文档目的

本文档为银行卡活跃度查询接口规范,以帮助商户技术人员快速接入活跃度查询功能,并快速掌握其相关功能,便于尽快的投入使用。

1.2阅读对象

  • 商户开发人员、维护人员和管理人员
  • 宝付相关的技术人员

1.3技术支持

在开发或使用宝付辅助交易接口时,如果您有任何技术上的疑问,请按如下方式寻求帮助,宝付技术支持人员会及时处理,给予您答复:

技术支持热线:021-68819999-8005
技术支持Email:support@baofoo.com
技术支持QQ:800066689

2.接口须知

2.1 术语定义

符号 符号性质 符号说明
M 强制域(Mandatory) 必须填写的域
C 条件域(Conditional) 某条件成立时必须填写的域
O 选用域(Optional) 选填属性(可选预)
R 原样返回域(Returned) 必须与先前报文中对应域的值相同的域

2.2 返回码说明

当header的 sysRespCode 为S_0000时,body的retCode如下:
1.retCode=1 说明接口调用成功。具体业务是否成功。看具体的参数字段。
2.retCode=0 说明接口调用失败。异常或者参数校验失败。
3.retCode=2 说明接口调用处理中。需要调用查询接口查询状态。
当header的 sysRespCode 为非S_0000时,系统异常或者校验失败。和具体业务无关联。

3.卡列表查询接口

3.1接口说明

  1. 报文编号:1.T-1001-007-21
  2. 接口用于查询银行卡交易情况
  3. 该接口为同步请求
    注:请求地址请结合宝付交易统一入口文档查看

3.2请求报文说明:

参数名称 类型 长度 出现要求 参数备注
version String 5 M 版本号4.0.0
tradeNo String [1,32] M 请求流水号
idNo String [18] M 身份证号
cardType String [1,64] O 101:借记卡,102:信用卡

3.3返回报文说明

参数名称 类型 长度 出现要求 参数备注
retCode int 4 M 返回码
errorCode String 20 C 错误码
errorMsg String 40 C 错误原因
tradeNo String 32 C 请求流水号
timeDescList List C 按照交易时间返回银行编码
timeDescList[bankCode] M
timeDescList[cardType] C 请求参数cardType传值时不返回
freqDescList List C 按照交易次数返回银行编码
freqDescList[bankCode] M
freqDescList[cardType] C 请求参数cardType传值时不返回

4.注意事项

初次使用请仔细核对,信息是否有误,出现错误请及时联系宝付技术人员。

5 附录

5.1 返回码

retCode 说明
1 成功
0 失败
2 处理中

5.2 宝付统一入口须知

宝付交易统一入口接口文档

作者:xiaofeng  创建时间:2024-09-27 14:19
最后编辑:xiaofeng  更新时间:2025-01-09 17:50