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.T-1001-007-21
- 接口用于查询银行卡交易情况
- 该接口为同步请求
注:请求地址请结合宝付交易统一入口文档查看
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
最后编辑:xiaofeng 更新时间:2025-01-09 17:50