Skip to content

分账方提现

分账方发起提现,提现结果可以根据通知地址回调给商户

请求路径/share/holder/withdraw
请求方法POST

请求参数

公共参数

参数名称类型必填说明
key标识string开发者唯一标识
time时间戳string当前unix时间戳,精确到秒
sign数据签名string数据签名,详见 签名算法
data业务参数JSON string业务参数,详见下例表格

业务参数

参数名称类型必填说明
amount金额float金额
code分账方编码string分账方编码
provider_id所属收单机构int所属收单机构
notifyurl通知地址string提现结果通知,失败或成功都会通知,通知数据结构见返回数据的业务数据

请求示例

json
{
    "data": "{\"amount\":11,\"code\":\"H3869895\",\"notifyurl\":\"https://xxx.hbsk.com/test/faked\",\"provider_id\":43500}",
    "key": "d4247ed86e99865b93a",
    "sign": "6fe0a154736ff76b9d9f9530c027469b4305723db115260596ee5e5b256d4dad",
    "time": 1690361541
}

返回数据

公共数据

数据名称类型必填说明
code状态码int结果状态码
text操作结果string操作结果,为空时不返回此字段
time时间戳int服务器当前unix时间戳,精确到秒
data业务数据JSON string业务数据
sign数据签名string数据签名

业务数据

数据名称类型必填说明
idIDint提现ID
type类型int见类型表
sequence游水号string游水号,可根据此值查询提现记录
amount金额float提现金额,精确到 2 位小数,如 1.00
before提现前余额float提现前余额,精确到 2 位小数,如 1.00
after提现后余额float提现后余额,精确到 2 位小数,如 1.00
state状态string订单状态,详见状态表
remark备注string备注
fee手续费额float
receive实收float实收
reason失败原因string失败原因
holder_code分账方编号string分账方编号

状态表

参数说明
pending待处理
process已处理
submit已提交
confirm已确认
failure失败
success成功
finish已完成

返回状态

状态说明
0查询成功
1003001查询失败
1002012无效分账方