API REFERENCE

Asynchronous payment split notifications

YabandPay documentation·Updated Oct 26, 2026

Response parameters:

{
    "sign": "YOUR_SIGNATURE",
    "data": {
        "user": "9212776037",
        "split_id": "20231229110618372777",
        "trade_id": "67943b0b-ca6b-aa96-5fb1-e354975f1ec4",
        "state": "Processing",
        "merchant_mid": "123",
        "merchant_name": "123",
        "reference_id": "123456",
        "split_solution_id": "104",
        "split_completed": 1,
        "created_at": "1703819178",
        "notify_url": "https://www.yabandpay.com/notify",
        "currency": "EUR",
        "receivers": [
            {
                "merchant_mid": "222",
                "merchant_name": "222",
                "detail_reference_id": "123456-2",
                "split_detail_id": "20231229110618372777-2",
                "split_type": "Split",
                "split_amount": "5.00",
                "role": "1",
                "result": "Processing",
                "description": "分账描述2",
                "error_msg": null
            },
            {
                "merchant_mid": "111",
                "merchant_name": "111",
                "detail_reference_id": "123456-1",
                "split_detail_id": "20231229110618372777-1",
                "split_type": "Split",
                "split_amount": "10.00",
                "role": "2",
                "result": "Processing",
                "description": "分账描述1",
                "error_msg": null
            }
        ],
        "type": "splitPayment"
    }
}

Response parameters

Parameter	Type	Description
user	String	UID of the super administrator account
split_id	String	Payment split order number generated when the payment split is created
trade_id	String	trade_id of the YabandPay order
split_solution_id	String	Payment split solution ID
state	String	Status: Processing, Success, Failed, Cancelled
merchant_mid	String	mid of the merchant splitting the payment
merchant_name	String	Name of the merchant splitting the payment
created_at	String	Creation timestamp
currency	String	Order settlement currency, Settlement Currency
notify_url	String	Asynchronous notification URL
split_completed	String	Whether the payment split is complete: 0: No, 1: Yes
reference_id	String	Merchant's payment split ID, no longer than 32 characters
reference	String	Description, no longer than 128 characters
type	String	Type: splitPayment or splitRefund
receivers	String	Payment split recipient information in JSON format
receivers.merchant_mid	String	mid of the payment split recipient
receivers.merchant_name	String	Merchant name of the payment split recipient
receivers.split_detail_id	String	Payment split detail number generated when the payment split is created
receivers.detail_reference_id	String	Merchant's payment split detail number
receivers.split_type	String	Payment split type: Split or Return
receivers.split_amount	String	Payment split amount
receivers.role	String	Payment split recipient role
receivers.result	String	Status: Processing, Success, Failed, Cancelled
receivers.description	String	Payment split detail description
receivers.error_msg	String	Error message for the payment split detail; populated when result is Failed