Skip to content

分账撤销 ​

分账撤销接口使用说明: ​

1.分账撤销接口调用之前,请先调用分账方余额查询接口,确保可用余额充足才能发起撤销; ​

2.异步通知: ​

分账撤销接口调用成功后,资金会从分账方钱包账户划转到商户待分账账户,到账时间通常 1-10 分钟不等,到账终态会异步通知 notifyurl 地址(会多次通知,请做好去重),异步通知返回的数据结构参考“分账撤销查询”接口返回的数据结构;

注意:目前仅支持招商交易管家,招商灵薪发通道
请求路径/share/revoke
请求方法POST

请求参数 ​

公共参数 ​

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

业务参数 ​

sequence流水号string是申请流水号,必须唯一
origin_sequence原始分账申请流水号string是原始分账申请流水号,必须唯一
notifyurl异步通知地址string否分账完成异步通知地址
remark备注string否备注

请求示例 ​

json
{
  "key": "d787d45a68b48",
  "data": "{\"orders\":[\"2022111791728765\",\"2022111791729812\",\"2022111791723115\"],\"holders\":[{\"amount\":1,\"code\":\"H7638527\"},{\"amount\":2,\"code\":\"H7633498\"}],\"onself\":false,\"sequence\":\"2022111767655444\"}",
  "sign": "b649ef89371dbd5c47686efbabf2e65....",
  "time": 1668671935
}

返回数据 ​

公共数据 ​

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

业务数据 ​

参数名称类型必填说明
sequence流水号string是流水号,必须唯一
amount申请总额float是申请总额,精确到2位小数,如1.00
fee分账服务费float是分账服务费,精确到2位小数,如1.00
total结算总额float是结算总额,精确到2位小数,如1.00
holders分账方[json]是分账方列表
code分账方编码string是分账方编码
amount分账金额float否分账比例/分账金额二选一
sequence流水号string否流水号,用于下载交易凭证
state状态string是状态(process:处理中、confirm:确认中、success:成功、failure:失败)
state状态string是分账撤销状态
remark备注string否备注

返回状态 ​

状态码说明
0申请成功