1.文档说明

1.1文档目的

本文档的目的是为支付条线辅助交易系统定义一个接口规范，以帮助商户/集团技术人员快速接入宝付辅助交易系统相关接口。

1.2阅读对象

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

1.3技术支持

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

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

DEMO下载

2.接口须知

2.1术语定义

3.当前余额查询接口

3.1接口说明

1. 报文编号：T-1001-006-03
2. 接口用于查询指定商户账户余额
   注：请求地址请结合宝付交易统一入口文档查看

3.2请求报文说明：

3.3返回报文说明

查询单个类型账户返回参数

示例

{
    "accountType": "BASE_ACCOUNT",
    "balance": 10526.49,
    "retCode": 1
}

查询所有类型账户【ALL】返回参数

示例

{
    "queryBalanceDetailResDtoList": [{
            "accountType": "BASE_ACCOUNT",
            "balance": 10526.49
        },
        {
            "accountType": "UNSETTLE_ACCOUNT",
            "balance": 50000.00
        },
        {
            "accountType": "FREEZE_ACCOUNT",
            "balance": 0.00
        },
        {
            "accountType": "MARGIN_ACCOUNT",
            "balance": 20000.00
        },
        {
            "accountType": "FEE_ACCOUNT",
            "balance": 0.00
        }
    ],
    "retCode": 1
}

4.历史日终余额查询接口

4.1接口说明

1. 报文编号：T-1001-006-44
2. 接口用于查询指定商户账户历史日终余额
   注1：历史记录查询查询时间不超过一周，不能查询当天记录。当日请用“当前余额查询接口”。
   注2：请求地址请结合宝付交易统一入口文档查看。
3. 由于大数据跑批时间差问题，建议T日6点后查询T-1日的数据。
4. 如果查询结果为空值或者未返回值，则表示可能无交易记录或账户为初始状态。

4.2请求报文说明：

说明：
A）“startDate”“endDate”
如无特殊需求，建议“startDate”“endDate”传同一天，按天查询。

4.3返回报文说明

说明：
A）“balanceMap”
“balanceMap”为key-valure值。
key1=”日期”:[value1={list}]
list={“accountType”:”账户类型”, “balance”:”金额”}，{“accountType”:”账户类型”, “balance”:”金额”}

balanceMap示例：

"balanceMap":{
            "2023-11-22":[
                {
                    "accountType":"BASE_ACCOUNT",
                    "balance":976.01
                },
                {
                    "accountType":"FEE_ACCOUNT",
                    "balance":4.2
                }
            ],
            "2023-11-23":[
                {
                    "accountType":"BASE_ACCOUNT",
                    "balance":984.28
                },
                {
                    "accountType":"FEE_ACCOUNT",
                    "balance":4.2
                }
            ]
        },

5.注意事项

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

附录

1、返回码

2、宝付统一入口须知

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