Appearance
申请退分账
说明:申请分账接口是把商户 FUND_ACCOUNT(资金账户)的钱转入自己或者他人的 DIVIDE_ACCOUNT (分账账户)中,分账账户中的钱再调用 完成分账 接口后,钱会转入 SETTLE_ACCOUNT (结算账户)中,结算账户中的钱支持 D1 自动结算到银行卡(无手续费)。
公共参数
参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
---|---|---|---|---|---|
mch_no | String | 是 | 32 | 商户号 | 2014072300007148 |
method | String | 是 | 128 | 接口名称,固定传 trade.apply.divide.back | trade.apply.divide.back |
charset | String | 是 | 10 | 调用的接口版本,固定为:utf-8 | utf-8 |
sign_type | String | 是 | 10 | 商户生成签名字符串所使用的签名算法类型,目前支持 RSA | RSA 或 rsa |
sign | String | 是 | 344 | 商户请求参数的签名串 | 详见示例 |
timestamp | String | 是 | 19 | 发送请求的时间,格式"yyyy-MM-dd HH:mm:ss" | 2014-07-24 03:07:50 |
version | String | 是 | 3 | 调用的接口版本,固定为:1.0 | 1.0 |
notify_url | String | 否 | 200 | 分账异步通知地址,200 个字符之内,建议上传 | http://localhost/notify.html |
biz_content | String | 是 | 业务参数 |
业务参数
参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
---|---|---|---|---|---|
divide_out_trade_no | String | 是 | 64 | 商户的分账的订单号 | 20150320010101001 |
divide_back_out_trade_no | String | 是 | 64 | 商户此次请求退分账的请求号(可理解为退分账订单号, 唯一) | 20150320010101002 |
divide_back_detail | String | 是 | 256 | 分账详情,json 字符串,account 是分账账号,amount 是分账金额 | [{"account":"10021011", "amount":"100"}, {"account":"10021012", "amount":"50"}] |
parent_merchant_no | String | 否 | 64 | 分账发起者商户号父级商户号 (与下单商户有区别, 分账特有) | 1001213 |
merchant_no | String | 否 | 64 | 分账发起者商户号 (与下单商户有区别, 分账特有) | 1002341 |
返回信息
json
返回结果示例:
{
"code": 20000,
"msg": "success",
"trade_no": "623884775041200128",
"out_trade_no": "623884775041200128",
"divide_back_detail": [
{
"amount": "0.01",
"account": "10089182583"
}
],
"divide_back_res_detail": [
{
"amount": "0.01",
"account": "10089182583",
"divideDetailNo": "1010202403070000010445487794",
"uniqueDivideNo": "1003202403070000010445487797"
}
],
"merchant_no": "21573050824562",
"divide_trade_no": "623884775041200121",
"divide_out_trade_no": "123",
"divide_back_trade_no": "623884775041200121",
"divide_back_out_trade_no": "123",
"divide_back_status": "DIVIDE_PENDING",
"divide_back_create_time": 1709713680,
"sign": "qAx66QBkm3qRss3oY5nuhiBCuic+HKYPAsr6omsoKn/SRGeJ6xj+gUuIIjChYXNFc/PX7BJjyXcCTW+L9M7qJwm9dssgUhG0798gY8rplUlKU0OEc4UnA2aBoBxcgqkvW9VkqQ05V0UTOdWvNL71ipkjZJBkUjpyC6OmapryfkgGJORjvCDwTumb70E7HEIbzrEwD8aNUJwil6u+WYcocGvz0hMVFgZ5GI/o6EvppTqniUbsZd/ZUTkCcg85cbYZn9Q5IW7dVVfrzKKTjtsqYieBJ3jDS6uyxjPaOBhSZwmAJma9MzRSUivTI0zZlTNVuCYspi1Zt79z+8GaCOnu+g=="
}
返回字段说明
参数 | 类型 | 描述 |
---|---|---|
code | Int | 20000 |
msg | String | success |
trade_no | String | 鸿闻的支付订单号 |
out_trade_no | String | 商户的支付订单号 |
divide_back_detail | String | 分账申请的详情, json 串 (account:分账接收方商户号, amount:分账金额) ,例子: [{"account":"10021011", "amount":"100"}, {"account":"10021012", "amount":"50"}] |
divide_back_res_detail | String | 分账返回的详情,json 串 (在需要先退回分账再退款的需求中,此结果很重要,建议本地留存,退分账的时候需要) |
merchant_no | String | 商户号 |
divide_trade_no | String | 鸿闻的分账订单号 |
divide_out_trade_no | String | 商户分账的请求号(商户的分账订单号) |
divide_back_create_time | String | 分账发起时间 |
divide_back_status | String | DIVIDE_BACK_SUCCESS(成功), DIVIDE_BACK_FAILED(失败), DIVIDE_BACK_PENDING(处理中) |
sign | String | 签名字符串 |