资金退回

⚠️⚠️接口说明

该接口主要用于把银行账户中的资金调拨回收单商户号,可调拨余额为一级户(平台商户)余额户余额,通过此接口调拨资金后,宝财通一级户(平台商户)的余额会减去对应的资金,请关注一级户(平台商户)可分账金额,以免造成无法分账。

此接口主要场景是用于调拨一部分资金给收单商户号作退款之用,解决收单商户号结算至银行电子户后,收单商户号在无收单资金的情况下无法退款的情况。

是否调拨入账成功,目前可通过余额查询接口【余额查询】中的“基本户”查询是否入金加值成功。仅有收单交易时,结算完成后基本户余额应为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