Recursos para IA

Configurar notificaciones

Las notificaciones Webhooks, también conocidas como devoluciones de llamada web, son un método efectivo que permiten a los servidores de Mercado Pago enviar información en tiempo real cuando ocurre un evento específico relacionado con tu integración. En lugar de que tu sistema realice consultas constantes para verificar actualizaciones, los Webhooks permiten la transmisión de datos de manera pasiva y automática entre Mercado Pago y tu integración a través de una solicitud HTTPS POST, optimizando la comunicación y reduciendo la carga en los servidores.

Configurar Webhooks

A continuación, te mostramos paso a paso cómo recibir notificaciones de transacciónes en tus integraciones con Payouts. Una vez configuradas, las notificaciones Webhook se enviarán cada vez que ocurra cualquier actualización sobre el tema reportado, incluyendo la creación de una transacción o cambios de estado durante el procesamiento.

A través del campo notification_url puedes configurar las notificaciones Webhook al realizar la llamada para crear una transacción. Solo tienes que completarlo con la URL donde quieres recibir las actualizaciones.

curl
--data '{
  ...
  "seller_configuration": {
    "notification_info": {
      "notification_url": "http://example.com/notification"
    }
  }
  ...
}'

Observa a continuación ejemplos que ilustran los mensajes devueltos cuando ocurre un evento.

Mensaje al crear una transacción:

json
{
  "created_date": "2026-01-29T15:20:25.470+00:00",
  "external_reference": "test_mp-bank",
  "id": "736669",
  "last_updated_date": "2026-01-29T15:20:25.470+00:00",
  "payout": {
    "external_reference": "global_111",
    "id": "26722",
    "notification_url": "https://webhook.site/a12e4590-1fb4-4a71-8326-5a3bbc9b4bcb"
  },
  "status": "created"
}

Mensaje cuando se actualiza una transacción:

json
{
  "created_date": "2026-01-29T15:20:25.470+00:00",
  "external_reference": "test_mp-bank",
  "id": "736669",
  "last_updated_date": "2026-01-29T15:20:25.470+00:00",
  "payout": {
    "external_reference": "global_111",
    "id": "26722",
    "notification_url": "https://webhook.site/a12e4590-1fb4-4a71-8326-5a3bbc9b4bcb"
  },
  "status": "processed",
  "status_detail": "approved"
}

El atributo payout.id corresponde al ID del payout sobre el cual estás siendo notificado, el parámetro id será el identificador de la notificación y el status te indicará si se creó la transacción o si se actualizó.

Acciones necesarias después de recibir la notificación

Cuando recibes una notificación en tu plataforma, Mercado Pago espera una respuesta para validar que esa recepción fue correcta. Para eso, debes devolver un HTTP STATUS 200 (OK) o 201 (CREATED).

El tiempo de espera para esa confirmación será de 22 segundos. Si no se envía esta respuesta, el sistema entenderá que la notificación no fue recibida y realizará un nuevo intento de envío cada 15 minutos, hasta que reciba la respuesta. Después del tercer intento, el plazo será prorrogado, pero los envíos continuarán sucediendo.

Luego de responder la notificación y confirmar su recepción, puedes obtener toda la información sobre el recurso notificado realizando un GET al endpoint /v1/payouts/{payout_id}/transactions/{transaction_id}API.