API REFERENCE

回退分账

YabandPay 文档·更新于 2026年10月26日

此接口对YabandPay分账成功的分账单进行回退

小贴士

注意：每个分账只能最多只能回退10次。

参数	类型	描述	是否必填
user	String	超级管理员账号的UID	必填
sign	String	签名	必填
method	String	v3.SplitPayment	必填
time	Long	时间戳	必填

参数

参数	类型	描述	是否必填
command	String	returnSplitPayment	必填
currency	String	订单结算货币，Settlement Currency	必填
notify_url	String	异步通知地址	必填
nonce_string	String	随机字符串，不长于32位	必填
split_id	String	创建分账后返回的分账订单id	必填
reference_id	String	商户方的分账回退id，不长于32位，不能重复	必填
reference	String	描述信息，不长于128位	选填
receivers	String	分账接收方信息，json格式	必填
receivers.mid	String	分账接收方的mid	必填
receivers.split_detail_id	String	创建分账后返回的分账明细id	必填
receivers.detail_reference_id	String	分账接收方的分账回退明细单号	必填
receivers.split_amount	String	分账金额	必填
receivers.description	String	分账明细描述	必填

签名示例：

拼接为URL方式并排序后的字符串

"command=returnSplitPayment&currency=EUR&method=v3.SplitPayment&nonce_string=qxg9mzdxxh4pyi9fhb&notify_url=https://www.yabandpay.com/notify&receivers=[{"mid":111,"split_amount":2,"split_detail_id":"20231229110618372777-1","detail_reference_id":"123456-1","description":"分账回退描述1"},{"mid":222,"split_amount":1,"split_detail_id":"20231229110618372777-2","detail_reference_id":"123456-1","description":"分账回退描述2"}]&reference=19398394598568&reference_id=123456&split_id=20231229110618372777&time=1703829894&trade_id=67943b0b-ca6b-aa96-5fb1-e354975f1ec4&user=9212776037"

得到的 stringA 使用 secret_key做签名

得到的签名如下：

"YOUR_SIGNATURE"

提交示例：

{
    "user": "9212776037",
    "sign": "YOUR_SIGNATURE",
    "method": "v3.SplitPayment",
    "time": 1703829894,
    "data": {
        "command": "returnSplitPayment",
        "trade_id": "67943b0b-ca6b-aa96-5fb1-e354975f1ec4",
        "notify_url": "https://www.yabandpay.com/notify",
        "reference_id": "123456",
        "reference": "564635235",
        "currency": "EUR",
        "split_id": "20231229110618372777",
        "nonce_string": "qxg9mzdxxh4pyi9fhb",
        "receivers": "[{\"mid\":111,\"split_amount\":2,
        \"split_detail_id\":\"20231229110618372777-1\",\"detail_reference_id\":\"123456-1\",\"description\":\"分账回退描述1\"},{\"mid\":222,\"split_amount\":1,
       \"split_detail_id\":\"20231229110618372777-2\",\"detail_reference_id\":\"123456-1\",\"description\":\"分账回退描述2\"}]"
    }
}

返回示例：

{
    "status": true,
    "code": "200",
    "data": {
        "user": "9212776037",
        "split_id": "20231229110618372777",
        "trade_id": "67943b0b-ca6b-aa96-5fb1-e354975f1ec4",
        "state": "Success",
        "merchant_mid": "123",
        "merchant_name": "123",
        "reference_id": "123456",
        "reference": "564635235",        
        "split_solution_id": "104",
        "notify_url": "https://www.yabandpay.com/notify",
        "currency": "EUR",
        "created_at": 1703831332,
        "receivers": [
            {
                "merchant_mid": "111",
                "merchant_name": "111",
                "detail_reference_id": "123456-1",
                "split_detail_id": "20231229110618372777-1",
                "refund_split_detail_id": "20231229110618372777-1-1",
                "split_type": "Return",
                "split_amount": "2",
                "result": "Success",
                "description": "分账回退描述1",
                "error_msg": null
            },
            {
                "merchant_mid": "222",
                "merchant_name": "222",
                "detail_reference_id": "123456-1",
                "split_detail_id": "20231229110618372777-2",
                "refund_split_detail_id": "20231229110618372777-2-1",
                "split_type": "Return",
                "split_amount": "1",
                "result": "Success",
                "description": "分账回退描述2",
                "error_msg": null
            }
        ],
        "type": "splitRefund"
    },
    "message": ""
}

返回参数

参数	类型	描述
user	String	收银员账号的UID
split_id	String	创建分账后的分账单号
split_solution_id	String	分账方案id
state	String	状态有Success或Failed
merchant_mid	String	分账商户的mid
merchant_name	String	分账商户的商户名
created_at	String	创建时间戳
currency	String	订单结算货币，Settlement Currency
notify_url	String	异步通知地址
reference_id	String	商户方的分账id，不长于32位
reference	String	描述信息，不长于128位
type	String	类型，有splitPayment和splitRefund
receivers	String	分账接收方信息，json格式
receivers.merchant_mid	String	分账接收方的mid
receivers.merchant_name	String	分账接收方的商户名
receivers.split_detail_id	String	创建分账后的分账明细单号
receivers.detail_reference_id	String	商户方的分账明细单号
receivers.split_type	String	分账类型Split或Return
receivers.split_amount	String	分账金额
receivers.result	String	状态有Success或Failed
receivers.description	String	分账明细描述
receivers.error_msg	String	分账明细错误信息，result 状态为 Failed 时有值