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接口说明
- 报文编号: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.结算异步通知
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 更新时间:2025-06-05 10:43