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次

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

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.注意事项

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

附录

返回码

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