资金退回
⚠️⚠️接口说明
该接口主要用于把银行账户中的资金调拨回收单商户号,可调拨余额为一级户(平台商户)余额户余额,通过此接口调拨资金后,宝财通一级户(平台商户)的余额会减去对应的资金,请关注一级户(平台商户)可分账金额,以免造成无法分账。
此接口主要场景是用于调拨一部分资金给收单商户号作退款之用,解决收单商户号结算至银行电子户后,收单商户号在无收单资金的情况下无法退款的情况。
是否调拨入账成功,目前可通过余额查询接口【余额查询】中的“基本户”查询是否入金加值成功。仅有收单交易时,结算完成后基本户余额应为0,调拨成功后会有对应值。
该接口后续会限制单笔1万单日2万,单日5次成功调用。(目前暂未限制,预计后续2-3个版本内会限制,如做限制后续不再另做通知,请接入时做好限制措施)。
此接口需要申请权限方可使用,开展业务前,请联系宝付业务人员。
请求参数
接口编号:BCT3-3006-001-01
| 参数 | 字段名称 | 定义 | 必输项 | 备注 |
|---|---|---|---|---|
| version | 版本号 | String | M | 1.0.0 |
| requestNo | 流水号 | String | M | 请求流水号 |
| memberId | 平台商户号 | String | M | 一级商户号 |
| amount | 金额 | String | M | 单位:元 |
| noticeUrl | 结果通知地址 | String | M | |
| payeeMemberName | 收款方名称 | String | M | |
| payeeMemberId | 收款方商户号 | String | M | |
| summary | 摘要 | String | O |
返回参数:
| 参数 | 字段名称 | 定义 | 必输项 | 备注 |
|---|---|---|---|---|
| retCode | 返回码 | int | M | |
| errorCode | 错误码 | String | C | |
| errorMsg | 错误原因 | String | C | |
| requestNo | 请求流水号 | String | O | |
| status | 状态 | String | O | SUCCESS:成功 PROCESSING:处理中 FAIL:失败 |
| memo | 备注 | String | O |
{
header.sysRespCode:S_0000(请求正常,继续查看body)
body.retCode:1
body.status = SUCCESS (成功)
body.status = FAIL (失败)
body.status = PROCESSING (处理中)
body.retCode:0|2
body.errorCode = BF0001 (失败)
body.errorCode = 其他错误码 (异常,调用查询接口)
header.sysRespCode:S_E_9002(未知,调用查询接口)
header.sysRespCode:其他错误码(失败)
}
异步通知
报文编号:BCT3-3106-001-01
| 参数 | 字段名称 | 定义 | 必输项 | 备注 |
|---|---|---|---|---|
| type | 类型 | String | M | trade |
| requestNo | 请求流水号 | String | M | |
| status | 状态 | String | M | SUCCESS:成功 PROCESSING:处理中 FAIL:失败 |
| memo | 备注 | String | O | |
| amount | 金额 | String | ||
| payeeMemberId | 收款商户号 | String |