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接口说明
- 报文编号:T-1001-001-08
- 接口用于商户自动结算
- 自动结算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接口说明
- 报文编号:T-1001-001-09
- 接口用于商户查询自动结算状态
注:请求地址请结合宝付交易统一入口文档查看
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
最后编辑:xiaofeng 更新时间:2024-09-19 18:06