Antes de salir a producción, recomendamos probar el correcto funcionamiento de tu integración y del procesamiento de las transacciones. Esto te permitirá verificar si la integración se realizó correctamente y si las transacciones se están procesando sin errores. A continuación se detalla cómo realizar la prueba de integración.

Para probar tu integración con Payouts, crea transacciones enviando un POST, con tu Access Token de pruebaClave privada de la aplicación creada en Mercado Pago y que se utiliza en el backend. Puedes acceder a ella a través de Tus integraciones > Datos de la integración > Pruebas > Credenciales de prueba. y el header X-test-token:true al endpoint /v1/payoutsAPI para que la solicitud se realice en un entorno de pruebas.

curl
Copiar
curl --location 'https://api.mercadopago.com/v1/payouts' \
--header 'X-Idempotency-Key: {{SOME_UNIQUE_VALUE}}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
--header 'X-enforce-signature: false' \
--header 'X-test-token: true' \
--data-raw '{
    "external_reference": "000197",
    "config": {
        "notification_url": "https://link-your-webhook-notification.com"
    },
    "description": "Payout for seller commissions",
    "schedule_date": "2026-12-31T14:30:00",
    "transactions": [
        {
            "type": "account",
            "description": "Payment to seller Beltrano",
            "account": {
                "email": "test_user_mx@testuser.com"
            },
            "amount": {
                "currency": "MXN",
                "value": 1
            },
            "external_reference": "000197"
        }
    ]
}'

Si la ejecución fue exitosa, recibirás como respuesta un status code 202, indicando que la transacción fue aceptada, como en el siguiente ejemplo.

json
Copiar
{
    "id": "POP01KV681P6SJ38NQHWX3XK162SS",
    "external_reference": "0001234",
    "description": "description_root",
    "idempotency_key": "021957ca-7271-4f5e-8b8d-70ed87ce1a61",
    "created_date": "2026-06-15T14:17:36-06:00",
    "status": "created",
    "config": {
        "notification_url": "https://notification_url.com"
    },
    "transactions": [
        {
            "id": "TOP01KV681P6SJ38NQHWX3SF2WM22",
            "amount": {
                "currency": "MXN",
                "value": 11
            },
            "external_reference": "0001234"
        },
        {
            "id": "TOP01KV681P6SJ38NQHWX3T9PHH3M",
            "amount": {
                "currency": "MXN",
                "value": 12
            },
            "external_reference": "0001235"
        }
    ]
}

¡Listo! Una vez finalizado este paso, la integración estará completa y podrás salir a producción.