API REFERENCE

Reembolsar una divesión de pago

YabandPay documentation·Actualizado el 26 oct 2026

Parámetros

Parameter	Type	Descripción	Obligatorio
data.command	string	returnSplitPayment	✓
data.currency	string	订单结算货币，Settlement Currency	✓
data.notify_url	string	异步通知地址	✓
data.nonce_string	string	随机字符串，不长于32位	✓
data.split_id	string	创建分账后返回的分账订单id	✓
data.reference_id	string	商户方的分账回退id，不长于32位，不能重复	✓
data.reference	string	描述信息，不长于128位	—
data.receivers	string	分账接收方信息，json格式	✓

Esta API devuelve una divesión de pago de YabandPay completada correctamente.

Consejo

Nota: Cada divesión de pago se puede devolver como máximo 10 veces.

Parámetro	Tipo	Descripción	Obligatorio
user	String	UID de la cuenta de superadminestrador	Obligatorio
sign	String	Signature	Obligatorio
method	String	v3.SplitPayment	Obligatorio
time	Long	Timestamp	Obligatorio

Parámetros

Parámetro	Tipo	Descripción	Obligatorio
command	String	returnSplitPayment	Obligatorio
currency	String	Moneda de liquidación del pedido, Settlement Currency	Obligatorio
notify_url	String	URL de notificación asíncrona	Obligatorio
nonce_string	String	Cadena aleatoria de un máximo de 32 caracteres	Obligatorio
split_id	String	ID del pedido de divesión de pago devuelto al crearla	Obligatorio
reference_id	String	ID único de devolución de divesión de pago del comercio, de un máximo de 32 caracteres	Obligatorio
reference	String	Descripción, de un máximo de 128 caracteres	Opcional
receivers	String	Información del destinatario de la divesión de pago en formato JSON format	Obligatorio
receivers.mid	String	MID del destinatario de la divesión de pago	Obligatorio
receivers.split_detail_id	String	ID del detalle de divesión de pago devuelto al crearla	Obligatorio
receivers.detail_reference_id	String	Número de detalle de devolución de divesión para el destinatario	Obligatorio
receivers.split_amount	String	Importe de la divesión de pago	Obligatorio
receivers.description	String	Descripción del detalle de divesión de pago	Obligatorio

Ejemplo de firma:

Parámetros ordenados y concatenados en una cadena de consulta con formato de 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"

Firme la cadena A con secret_key

La firma resultante es:

"YOUR_SIGNATURE"

Ejemplo de solicitud:

{
    "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\"}]"
    }
}

Ejemplo de respuesta:

{
    "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": ""
}

Parámetros de respuesta

Parámetro	Tipo	Descripción
user	String	UID de la cuenta de cajero
split_id	String	Número de orden de divesión de pago generado al crear la divesión
split_solution_id	String	ID de configuración de divesión de pago
state	String	Status: Success or Failed
merchant_mid	String	MID del comercio que divide el pago
merchant_name	String	Nombre del comercio que realiza la divesión de pago
created_at	String	Marca de tiempo de creación
currency	String	Moneda de liquidación del pedido, Settlement Currency
notify_url	String	URL de notificación asíncrona
reference_id	String	ID de divesión de pago del comercio, de un máximo de 32 caracteres
reference	String	Descripción, de un máximo de 128 caracteres
type	String	Tipo: splitPayment o splitRefund
receivers	String	Información del destinatario de la divesión de pago en formato JSON format
receivers.merchant_mid	String	MID del destinatario de la divesión de pago
receivers.merchant_name	String	Nombre del comercio destinatario de la divesión de pago
receivers.split_detail_id	String	Número de detalle de la divesión de pago generado al crearla
receivers.detail_reference_id	String	Número de detalle de divesión de pago del comercio
receivers.split_type	String	Tipo de divesión de pago: Split o Return
receivers.split_amount	String	Importe de la divesión de pago
receivers.result	String	Status: Success or Failed
receivers.description	String	Descripción del detalle de divesión de pago
receivers.error_msg	String	Mensaje de error del detalle de divesión de pago; se completa cuando el resultado es Failed

Reembolsar una divesión de pago

Reembolsar una divesión de pago

Request parameters8

回退分账

Parámetros

Ejemplo de firma:

Ejemplo de solicitud:

Ejemplo de respuesta: