Probar la integración

Antes de salir a producción, recomendamos probar el funcionamiento de la integración y el procesamiento de las transacciones. Así, puedes verificar si la integración se configuró correctamente y si las transacciones se procesan sin errores.

Para probar tu integración con Payouts, crea transacciones enviando una solicitud con tu Access Token de pruebaClave privada vinculada a una aplicación, utilizada en el backend para autenticar operaciones en el entorno de prueba. Puedes consultarla en la sección Credenciales de la aplicación, dentro del entorno de prueba. No permite procesar pagos reales y nunca debe exponerse en el frontend. y el header X-test-token: true, al endpoint /v1/payoutsPOST, para que la solicitud se realice en un ambiente de prueba.

curl
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@testuser.com"
            },
            "amount": {
                "currency": "MXN",
                "value": 1
            },
            "external_reference": "000197"
        }
    ]
}'

Si la ejecución es exitosa, la solicitud devuelve un status code 202, lo que indica que el payout fue aceptado para su procesamiento. El siguiente ejemplo muestra un payout con dos transacciones:

json
{
   "id": "POP01KM145R903TZ06BWK6204DGG1",
   "external_reference": "000197",
   "description": "Payout for seller commissions",
   "idempotency_key": "1773859430",
   "created_date": "2026-03-18T14:43:50-06:00",
   "status": "created",
   "schedule_date": "2026-12-31T14:30:00",
   "config": {
       "notification_url": "https://link-your-webhook-notification.com"
   },
   "transactions": [
       {
           "id": "TOP01KKYN1QY2SS1MKAY4G9DV5NK9",
           "amount": {
               "currency": "MXN",
               "value": 10
           },
           "external_reference": "0001234"
       },
       {
           "id": "TOP01KV681P6SJ38NQHWX3T9PHH3M",
           "amount": {
               "currency": "MXN",
               "value": 12
           },
           "external_reference": "0001235"
       }
   ]
}

¡Listo! Una vez completado este paso, la integración está completa y puedes salir a producción.