1.文档说明

1.1文档目的

本文档的目的是为宝付对账文件定义一个接口规范，以帮助商户技术人员快速接入宝付对账系统。

1.2阅读对象

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

1.3技术支持

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

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

DEMO下载

友情提示：DEMO仅供开发者参考，实际参数以对应产品接口文档为准。
Demo版本 更新日期 下载链接
JAVA版 2023-06-30 点击下载
PHP版 2023-06-30 点击下载
NET版 2023-06-30 点击下载

1.4术语与定义

1.4.1符号含义

序号 符号缩写 符号性质 符号说明
1 M 强制域(Mandatory) 必须填写的属性，否则会被认为格式错误
2 C 条件域(Conditional) 某条件成立时必须填写的属性
3 O 选用域(Optional) 选填属性
4 R 原样返回域(Returned) 必须与先前报文中对应域的值相同的域

1.4.2术语含义

  • 商户号：宝付提供给商户的唯一编号，是商户在宝付的唯一标识；
  • 终端号：商户在与宝付签订某项具体产品功能的合作协议自动分配的会员属性，将用于进行具体交易的必要参数。
  • 商户流水号：商户请求宝付时提交的流水号，每次请求均不可重复；
  • 宝付交易号：宝付用于一笔订单的唯一标识；

2.业务接口说明

2.1.文件下载接口

功能说明

宝付对账文件下载以接口方式下载，以文件流的形式返回，商户接收压缩文件流，并解压文件。

对账文件URL

测试环境地址：https://vgw.baofoo.com/boas/api/fileLoadNewRequest
正式环境地址：https://public.baofoo.com/boas/api/fileLoadNewRequest

请求报文

序号 域名 变量名 必填 备注
1 版本号 version M 4.0.0.2
2 商户号 member_id M 宝付提供给商户的唯一编号
3 文件类型 file_type M 收单：fi；出款：fo；分期：bs；信用卡还款：ct；银企云：ci； 银行卡鉴权：jq；联合放款：fo_zf；冻结文件：freeze；小程序管控所有交易（非冻结）:aggr_all；小程序管控交易（冻结）:aggr_freeze；手续费账单：fee；收单合并文件：merge；
4 客户端IP client_ip M 商户下载文件所属IP须向宝付报备
5 清算日期 settle_date M 对账单日期,格式：yyyy-mm-dd

注：
1.下载对账文件须向宝付报备IP，只能由该IP下载文件。
2.宝付只为商户保留7天内的对账文件。

应答报文（宝付返回报文）

序号 域名 变量名 必填 备注
1 返回码 resp_code M 见应答码
2 返回信息 resp_msg M
3 返回文件体 resp_body R
4 预留域 reserved O 预留域

说明：1.文件流以字符串形式返回，请base64解密之后转换成zip文件输出

附录：

1.应答码

错误码 含义
0000 成功
0001 交易失败。详情请宝付
0003 交易通讯超时，请发起查询交易
0004 交易状态未明，请查询对账结果
0005 交易已受理，请稍后查询交易结果
0010 报文格式错误
0011 验证签名失败
0012 重复交易
0013 报文交易要素缺失
0014 此商户暂不支持该业务。

2.对账文件示例

对账文件下载为ZIP文件，解压后为txt文件。

fi对账文件示例：
商户号|终端号|交易类型|交易子类型|总笔数|总金额|总手续费|清算时间
100000276|100000990|04311|00|60|315664.20|0.00|2016-10-17
100000276|100000991|10311|00|4|2000.00|0.00|2016-10-17
商户号|终端号|交易类型|交易子类型|宝付订单号|商户订单号|清算日期|订单状态|交易金额|手续费|宝付交易号|支付订单创建时间|商户退款订单号|退款订单创建时间
100000276|100000990|04311|00|401579336|G0000101653|2016-10-17|1|603.00|0.00|201610160110000401579336|2016-10-17 11:15:40|
100000276|100000990|04311|00|401579350|G0000101655|2016-10-17|1|1.00|0.00|201610160110000401579350|2016-10-17 11:15:40|
100000276|100000990|04311|00|401579351|G0000101656|2016-10-17|1|4.00|0.00|201610160110000401579351|2016-10-17 11:15:40|
fi对账文件(含分账信息)示例：
商户号|终端号|交易类型|交易子类型|总笔数|总金额|总手续费|清算时间
120838|23462|15311|00|2|0.08|0.00|2017-03-31
120838|23462|10311|01|1|0.01|0.00|2017-03-31
120838|23462|10311|00|103|3750004.71|0.48|2017-03-31
120838|0|30511|00|1|0.01|0.01|2017-03-31
120838|23462|19311|00|2|0.12|0.00|2017-03-31
120838|23462|11311|00|6|0.07|0.04|2017-03-31
商户号|终端号|交易类型|交易子类型|宝付订单号|商户订单号|清算日期|订单状态|交易金额|手续费|宝付交易号|支付订单创建时间|商户退款订单号|退款订单创建时间|持卡人姓名-支付|持卡人身份证号-支付|银行卡号-支付|预留手机号-支付|持卡人姓名-退款|银行卡号-退款|分账商户号|分账金额|分账子商户手续费|分账创建时间|分账更新时间
120838|23462|15311|00|802975599|20170330204751237|2017-03-31|1|0.04|0.00|201703300110000802975599|2017-03-30 20:47:54|||||||||400215|0.03|0.00|2017-03-30 20:47:54|2017-03-31 08:04:50
120838|23462|15311|00|802975599|20170330204751237|2017-03-31|1|0.04|0.00|201703300110000802975599|2017-03-30 20:47:54|||||||||400001|0.01|0.00|2017-03-30 20:47:54|2017-03-31 08:04:50
120838|23462|19311|00|802990158|20170330210835463|2017-03-31|1|0.06|0.00|201703300110000802990158|2017-03-30 21:08:58|||||||||400215|0.01|0.00|2017-03-30 21:08:58|2017-03-31 08:04:50
120838|23462|19311|00|802990158|20170330210835463|2017-03-31|1|0.06|0.00|201703300110000802990158|2017-03-30 21:08:58|||||||||400001|0.05|0.05|2017-03-30 21:08:58|2017-03-31 08:04:50
fi对账文件(含合并支付)-子商户使用示例：
商户号|终端号|交易类型|交易子类型|总笔数|总金额|总手续费|清算时间
100028678|200004204|08317|00|1|847.49|0.00|2023-06-29
商户号|终端号|交易类型|交易子类型|宝付订单号|商户订单号（子单）|商户订单号（母单）|清算日期|订单状态|交易金额|手续费|宝付交易号|支付订单创建时间|商户退款订单号|退款订单创建时间|持卡人姓名-支付|持卡人身份证号-支付|银行卡号-支付|预留手机号-支付|持卡人姓名-退款|银行卡号-退款|子单金额|子商户手续费|子单创建时间
100028678|200004204|08317|00|5416873738|168802322201000007|602306297797906091|2023-06-29|1|847.49|0.00|202306290110005416873738|2023-06-29 15:20:40|||张三|bdcf7c466eb4640cb753658bb07b379b1b15b13d27347726774e6b5a7178a4e3|b59e3b084241c39269313ce2ad5c44d5b6f5ed2125cee8972de3d91d1519a427|a526d4e7e22055a31b7ef0a7a5df350e|||847.49|0.00|2023-06-29 15:20:33
fi对账文件(含组合支付)对账模板示例
商户号|终端号|交易类型|交易子类型|总笔数|总订单金额|营销商户号|总营销账户出款金额|总交易扣款金额|总手续费|清算时间
商户号|终端号|交易类型|交易子类型|宝付订单号|商户订单号|清算日期|订单状态|订单金额|营销商户号|营销账户出款金额|交易扣款金额|手续费|宝付交易号|支付订单创建时间|商户退款订单号|退款订单创建时间|持卡人姓名-支付|持卡人身份证号-支付|银行卡号-支付|预留手机号-支付|持卡人姓名-退款|银行卡号-退款|分账商户号|分账金额|分账子商户手续费|分账创建时间|分账更新时间|备注|卡类型
手续费定制对账模板示例
手续费承担商户号|交易商户号|终端号|产品|宝付订单号|商户订单号|订单金额|分账金额|手续费金额
收单和下发交易合并对账模板对账模板示例
商户号|终端号|交易类型|明细类型|交易子类型|宝付订单号|商户订单号|批次号|平台出款金额|清算日期|订单状态|交易金额|手续费|宝付交易号|订单创建时间|商户退款订单号|退款订单创建时间|持卡人姓名|持卡人身份证号|银行卡号-支付|预留手机号|银行卡号-退款|分账商户号|分账金额|分账子商户手续费|分账创建时间|分账更新时间|收款账号|收款户名|主商户号|预留字段1|预留字段2|预留字段3|预留字段4
fo对账文件示例：
商户号|终端号|交易类型|交易子类型|总笔数|总金额|总手续费|清算时间
100000178|0|00105|00|5|7994.83|10.00|2016-10-17
商户号|终端号|交易类型|交易子类型|宝付订单号|商户代付订单号|批次号|清算日期|订单状态|交易金额|手续费|收款人账号|收款人姓名|宝付交易号|代付订单创建时间|退款订单创建时间
100000178|0|00105|00|29058920|914083-202345|30750506|2016-10-17|1|3393.83|2.00|6217002300006546721|王宝宝|29058920|2016-10-17 11:15:40|
100000178|0|00105|00|29059286|914083-202347|30750750|2016-10-17|1|500.00|2.00|4563510100859514741|张宝宝|29059286|2016-10-17 11:20:30|
100000178|0|00105|00|29075496|914083-202351|30755964|2016-10-17|1|1.00|2.00|6217001630015038760|李宝宝|29075496|2016-10-17 13:01:15|
FO_ZF对账文件示例：（联合放款产品指令方对账文件展示）
商户号|终端号|交易类型|交易子类型|总笔数|总金额|平台出款总金额|总手续费|清算时间
120838|0|00106|00|2|5500.00|550.00|0.80|2019-05-12
商户号|终端号|交易类型|交易子类型|宝付订单号|商户代付订单号|批次号|清算日期|订单状态|交易金额|平台出款金额|手续费|收款人账号|收款人姓名|宝付交易号|代付订单创建时间|退款订单创建时间
120838|0|00106|00|243869478|190512081557SD4005fdc6|0|2019-05-12|1|3000.00|300.00|0.40|621700*********6721|任宝宝|243869478|2019-05-12 11:15:40|
120838|0|00106|00|243869623|190512081848SD40059583|0|2019-05-12|1|2500.00|250.00|0.40|621700*********1586|琚宝宝|243869623|2019-05-12 12:23:01|
JQ对账文件示例：
商户号|商户名称|对账日期|订单总笔数|订单手续费
120838|测试商户号|20190830|2|1.00
商户号|商户名称|商户订单号|宝付订单号|订单时间|产品细类|手续费金额|订单状态
120838|测试商户号|1111111|2222222|20190829140147|银行卡三要素认证|0.00|订单完成
120838|测试商户号|1234567|7654321|20190829135930|银行卡四要素认证|1.00|订单完成
BS对账文件示例：
商户号|终端号|交易类型|交易子类型|总笔数|总金额|总手续费|渠道总手续费|分期总金额|分期总手续费|分期服务费总金额|分润总金额|营销总金额|清算时间
400001||01377|00|2|1000.00|51.04|0.04|1000.00|51.00|0.00|0.00|0.00|2018-10-24
商户号|子商户号|终端号|交易类型|交易子类型|订单类型|商户订单号|宝付订单号|清算日期|订单状态|交易金额|手续费|渠道手续费|分期金额|分期数|分期手续费|分期服务费|分润金额|营销金额|分账商户号|入账方|手续费承担方
400001|120838|23462|01377|00|00|b7a91ca56a144301b90582278d268d8d|2573760016|2018-10-24|1|500.00|25.52|0.02|500.00|3|25.50|||||400001|120838
400001|120838|23462|01377|00|00|ecffc23f648046d9a41b42005bf07d42|2574146252|2018-10-24|1|500.00|25.52|0.02|500.00|3|25.50|||||400001|120838
CT对账文件示例：
商户号|终端号|交易类型|交易子类型|总笔数|总金额|总手续费|清算时间
120838|23462|11111|00|3|1586.99|6.00|2018-10-31
商户号|终端号|交易类型|交易子类型|宝付订单号|商户订单号|清算日期|订单状态|还款金额|扣款金额|补贴金额|手续费|付款方帐号|收款方帐号|收款方姓名|订单创建时间
120838|23462|11111|00|100649|6463295290405314560|2018-10-31|1|10.00|10.00|0.00|2.00|625965******9717|621700*********1339|肖玮军|2018-10-31 15:07:59
120838|23462|11111|00|100650|6463309219338829824|2018-10-31|1|1556.99|1556.99|0.00|2.00|625965******9717|621700*********1339|肖玮军|2018-10-31 16:03:20
120838|23462|11111|00|100651|6463314013130768384|2018-10-31|1|20.00|0.00|20.00|2.00|625965******9717|621700*********1339|肖玮军|2018-10-31 16:22:23
CI对账文件示例：
商户号|终端号|交易类型|交易子类型|总笔数|总金额|清算时间
120838|23462|04385|00|2|244.12|6.00|2019-09-29
商户号|终端号|交易类型|交易子类型|宝付订单号|商户订单号|清算日期|订单状态|交易金额|宝付交易号|支付订单创建时间|商户退款订单号|退款订单创建时间|银行120838|23462|04385|00|4259757413|PT2019092906000202|2019-09-29|1|240.00|201909290110004259757413|2019-09-29 11:28:18|||
120838|23462|04385|00|4259870970|PT2019092906000301|2019-09-29|1|4.12|201909290110004259870970|2019-09-29 11:53:29|||
fo_zf对账文件示例：
商户号|交易类型|交易子类型|清算日期|订单状态|交易金额|收款人账号|收款人姓名|备注
1234166|00106|00|2020-01-08|1|0.99|1700*********1339|肖玮军|60
freeze对账文件（此类型需单独申请）示例：
商户号|冻结类型|汇总金额|总笔数|日期
宝付订单号|订单成功时间|商户号|冻结金额|创建时间|冻结原因|冻结类型|交易类型|分账宝付订单号|订单类型|商户订单号

注意：
1、对账单中，终端号为0的记录为“宝付商户后台”充值记录或代付出款订单；
2、对账单中只有支付成功的订单，没有失败或未支付等其他状态记录；
3、调用本接口需要绑定请求服务器出口IP，并从绑定之日开始生成对账单，绑定日之前的对账单记录不会生成。
4、次日生成当日对账单，推荐商户在早上9:00以后开始获取。

3.交易类型

产品类型交易类型取值
支付卡类00313
B2C01311
B2B01311
Wap01311
银联手机支付（插件支付）06311
认证支付API04311
认证支付PC03311
认证支付WAP05311
认证支付SDK08311
委托还款09311
代扣10311
分账产品-API类14311
分账产品-代扣15311
分账产品-认证SDK16311
分账产品-认证WAP17311
分账产品-认证PC18311
分账产品-快捷19311
分账产品-协议支付31311
非实时代扣20311
分账产品-非实时代扣21311
分账产品-分账过账15323
分账产品-分账不过账04317
协议支付分账-不过账06317
协议支付分账-过账31323
支付宝支付13311
微信支付12311
快捷支付11311
协议支付30311
余额支付79311
账户07311
转账支付60311
信用卡分期01377
非实时协议支付32311
合并支付08317
冻结01501
转账支付-分账60317
充值B2C网银01301
B2B网银01301
线下打款01301
快捷01301
手续费账户30511
转账转账到银行00105
转账到账户00104
联合放款00106
提现普通提现00101
结算自动结算00102
服务认证银行卡验证03371
身份证验证02371
民生信用卡还款11111
信用卡还款2.0信用卡还款2.0代收45210
信用卡还款2.0代付00213
银企云代扣01385
非实时代扣02385
微信支付03385
支付宝支付04385
对公代扣05385
协议支付06385
组合支付协议支付组合支付收单进冻结20468
协议支付组合支付分账10666
协议支付组合支付收单零元进冻结30468
协议支付组合支付(零元)10316
微信组合支付进冻结户61468
微信组合支付收单零元进冻结户62468
支付宝组合支付进冻结户71468
支付宝组合支付收单零元进冻结户72468

4.交易子类型

交易子类型 取值
成功 00
退款 01
撤销 02

5.订单类型

订单类型 取值
主订单 00
分账 01

6.BS字段解释

汇总数据说明

字段名称 字段解释
商户号 平台商户号
终端号 null
交易类型 详见交易类型
交易子类型 订单类型
总笔数 订单总笔数
总金额 交易总金额
总手续费 交易总手续费（渠道总手续费+分期总手续费）
渠道总手续费 渠道收单费用汇总
分期总金额 分期交易金额汇总
分期总手续费 分期手续费汇总
分期服务费总金额 服务费
分润总金额 分润金额
营销总金额 营销金额汇总
清算时间 清算日期

明细数据说明

字段名称 字段解释
商户号 平台商户号
子商户号 子商户商户号
终端号 子商户终端号
交易类型 详见交易类型
交易子类型 详见交易子类型
订单类型 详见订单类型
商户订单号 商户发往宝付的订单号
宝付订单号 宝付生成的订单号（主单）
清算日期 清算日期
订单状态 00，只有成功
交易金额 商户发往宝付的订单金额
手续费 该笔订单的总手续费（渠道手续费+分期手续费）
渠道手续费 收单产生的交易手续费
分期金额 交易金额中用于分期消费的金额
分期数 分期的期数
分期手续费 分期产生的手续费
分期服务费 使用分期业务产生的服务费
分润金额 使用分期业务产生的服务费分润金额
营销金额 该笔订单的营销抵扣的金额
分账商户号 参与分账商户号
入账方 实际交易资金结算的商户号
手续费承担方 该笔主单产生的手续费承担方商户号

7.CT字段解释

汇总数据说明

字段名称 字段解释
商户号 平台在我司开设的商户号
终端号 null
交易类型 详见交易类型
交易子类型 订单类型
总笔数 订单总笔数
总金额 交易总金额
总手续费 交易总手续费
清算时间 清算日期

明细数据说明

字段名称 字段解释
商户号 平台在我司开设的商户号
终端号 子商户终端号
交易类型 详见交易类型
交易子类型 00：支付成功，01：退款成功
宝付订单号 信用卡还款订单号
商户订单号 商户发往宝付的订单号
清算日期 清算日期
订单类型 详见订单类型
订单状态 1：成功，仅有成功
还款金额 商户发往宝付的信用卡还款总金额（还款金额=扣款金额+补贴金额）
扣款金额 商户发往宝付扣除用户储蓄卡金额
补贴金额 商户营销活动补贴金额
手续费 每笔订单收取商户的手续费
付款方帐号 商户发往宝付扣款的储蓄卡账号
收款方帐号 商户发往宝付还款的信用卡账号
收款方姓名 商户发往宝付的信用卡还款姓名
订单创建时间 订单创建的时间

8.aggr_all字段解释

明细数据说明

字段名称 字段解释
商户号 平台在我司开设的商户号
终端号 子商户终端号
交易类型 详见交易类型
交易子类型 UNFREEZE：解冻 REFUND：退款 SUCCESS：成功
宝付订单号 宝付为该笔订单分配的订单号，如果是退款为原支付订单号
商户订单号 商户发起交易传入的订单号，如果是退款为原支付订单号
交易时间 订单支付成功时间，发起退款成功时间或者受控订单解冻时间
订单状态 S：成功，仅有成功
用户实际付款金额 用户实际付款金额，不包含营销金额
营销金额 该笔订单使用的营销金额
宝付退款订单号 宝付为该笔退款分配的退款单号
商户退款订单号 商户发起退款填入的商户退款单号
退款金额 该笔退款单的用户实际付款金额
营销退款金额 退款金额中包含的营销退款金额
宝付交易号 宝付为该笔订单分配的流水号，如果是退款为原支付宝付交易号
订单总金额 该笔订单的金额，包括用户实际付款金额，营销金额
申请退金额 商户发起的退款金额，包括退给用户的金额，营销金额
手续费 该笔订单对应的手续费金额，负数代表退还的手续费

9.aggr_freeze字段解释

明细数据说明

字段名称 字段解释
商户号 平台在我司开设的商户号
终端号 子商户终端号
交易类型 详见交易类型
管控状态 FREEZE：冻结
宝付订单号 宝付为该笔订单分配的订单号
商户订单号 商户发起交易传入的订单号
交易时间 订单支付成功时间
订单状态 S：成功，仅有成功
用户实际付款金额 用户实际付款金额，不包含营销金额
营销金额 该笔订单使用的营销金额
宝付交易号 宝付为该笔订单分配的流水号
订单总金额 该笔订单的金额，包括用户实际付款金额，营销金额
手续费 该笔订单对应的手续费金额
作者：xiaofeng  创建时间：2023-06-30 08:57
最后编辑：xiaofeng  更新时间：2025-01-09 17:41