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) 必须与先前报文中对应域的值相同的域

3.自动结算

3.1接口说明

1、报文编号:T-1001-001-08
2、接口用于商户自行进行结算(将可结算金额根据商户需求向对公户结算)
3、自动结算API不允许在工作日9:30分之前调拨;一天自动结算调拨次数不允许超过12次
4、结算模式:默认正常结算;其他模式暂不开放
5、结算周期:默认T1,若有节假日结算,传输D1;仅开放两种周期模式,结算金额策略不传默认全额;

注:请求地址请结合宝付交易统一入口文档查看

3.2请求参数

参数名称 类型 长度 出现要求 参数备注
version String 5 M 版本号4.0.0
memberId String [1,32] M 商户号
terminalId String [1,32] M 终端号
requestNo String [1,32] M 请求流水号
noticeUrl String [1,255] O 通知地址
settleMode String [1,32] O 结算模式 默认NORMAL正常结算
settleCycle String [1,32] O 结算周期 默认 :T1, 假节日:D1
settleAmtStrategy String [1,32] O 结算金额策略 默认ALL全部
ALL-全部
FIXED-固定
RATIO-比例
REMAIN-留存
calculateAmtValue decimal (10,2) O 结算金额策略值 默认不填

3.3返回参数

参数名称 类型 长度 出现要求 参数备注
retCode int 4 M 返回码
errorCode String 20 C 错误码
errorMsg String 40 C 错误原因
back1 String 64 O 备用字段
back2 String 64 O 备用字段
back3 String 100 O 备用字段
requestNo String [1,32] O 请求流水号
status String [1,32] O 状态 SUCCESS:成功 PROCESSING:处理中 FAIL:失败
memo String 100 O 状态描述

3.4异步通知结果:

1.宝付返回格式为JSON
2.商户接收到通知后务必在接收通知页面上返回大写OK
3.宝付系统在未确认商户接收通知成功后将会通过重发机制通知商户(重发次数10次,请以第一次收到的付款成功的消息为准,避免进行多次确认)通知发给商户。
4.通知接口Demo http://URL? member_id=1 & terminal_id=2 & data_type=JSON & data_content=密文

参数名称 类型 长度 出现要求 参数备注
memberId String [1,32] M 备用字段
requestNo String [1,32] M 请求流水号
status String [1,32] M 状态 SUCCESS:成功 PROCESSING:处理中 FAIL:失败
memo String 100 O 状态描述

4.自动结算查询接口

4.1接口说明

  1. 报文编号:T-1001-001-09
  2. 接口用于商户查询自动结算状态

注:请求地址请结合宝付交易统一入口文档查看

4.2 请求报文说明:

参数名称 类型 长度 出现要求 参数备注
version String 5 M 版本号4.0.0
memberId String [1,32] M 商户号
terminalId String [1,32] M 终端号
requestNo String [1,32] M 请求流水号

4.3返回报文说明:

参数名称 类型 长度 出现要求 参数备注
retCode int 4 M 返回码
errorCode String 20 C 错误码
errorMsg String 40 C 错误原因
back1 String 64 O 备用字段
back2 String 64 O 备用字段
back3 String 100 O 备用字段
requestNo String [1,32] O 请求流水号
status String [1,32] O 状态 SUCCESS:成功 PROCESSING:处理中 FAIL:失败
memo String 100 O 状态描述

5.结算异步通知

5.1 接口功能说明

将资金结果异步通知给商户

5.2 解密后报文说明:

序号 域名 变量名 必填 备注
01 商户号 memberId M
02 商户名称 memberName M
03 收款方卡号 payeeAccount M
04 收款方姓名 payeeName M
05 结算金额(元) settleAmount M
06 结算单号 settleOrderId M
07 结算时间 settleTime M

通知报文示例

member_id= 100000178&terminal_id=1000938&data_content=09f27e40024994307c854b5bff54fdbb79e7ed9900e6013e58a816e31ef39088f42417a5d87d05e01508b93bea5be2af8fa0562b8259b07eff3fb61fee70d69a5550561731b6bf1319a98091180490d6fd783af72d20e7bf53e3b924f6455f93d7234fff06fef004f05e6795903e21535a1b19fa75473fc99a8b8ff2aadc146f85bf2bb168ccfa724a77e24f4aea12ed0634b4810feed3c1c799bdbd03b98c8378ca5fa68efd1bccd54d8f9a7ad80912f8e5c29ff74f0b8bef247c4e4319f8778366f06f3b547f9586bf229e3b15bd38523999bb58f9c11fd68df33da5ad5d99f6a528c69b178248804da25b082ab08f9c504a4db70139f1a540614fa21cebb3

解密后报文


{
"memberId":"100018864",
"memberName":"个体户张三",
"payeeAccount":"621700*********0704",
"payeeName":"阿坤测试",
"settleAmount":"0.99",
"settleOrderId":406626323,
"settleTime":"2025-01-10 09:50:00"
}

注:宝付以GET和POST方式发送到商户配置的接收地址,商户接收到支付结果,并且进行相应处理之后,需要商户接收通知的地址在页面上输出 OK 表示接收成功<除了 OK 无任何其他内容>,告诉宝付已经成功接收并处理完毕,宝付系统在未得到商户接收通知成功的反馈时,将通过重发机制再次通知商户(重发次数 2~10 次,请以第一次收到的支付成功的消息为准,避免进行多次充值或支付),直到商户接收成功或达到最大重发次数为止。

6.注意事项

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

附录

返回码

retCode 说明
1 成功
0 失败
2 处理中
作者:xiaofeng  创建时间:2024-02-21 17:54
最后编辑:xiaofeng  更新时间:2025-06-05 10:43