Recursos para IA

Configurar notificações

As notificações Webhooks, também conhecidas como devoluções de chamada web, são um método eficaz que permitem aos servidores do Mercado Pago enviar informações em tempo real quando ocorre um evento específico relacionado à sua integração. Em vez de seu sistema realizar consultas constantes para verificar atualizações, os Webhooks permitem a transmissão de dados de maneira passiva e automática entre Mercado Pago e sua integração através de uma solicitação HTTPS POST, otimizando a comunicação e reduzindo a carga nos servidores.

Configurar Webhooks

A seguir, apresentaremos um passo a passo para poder receber notificações de transações em integrações com Payouts. Uma vez configuradas, as notificações Webhook serão enviadas sempre que ocorrer qualquer atualização sobre o tópico reportado, incluindo a criação de uma transação ou as atualizações de status durante o processamento.

Através do campo notification_url você pode configurar as notificações Webhooks ao fazer a chamada para criar uma transação. Basta preenchê-lo com a URL na qual você deseja receber as atualizações.

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

Veja abaixo exemplos que ilustram as mensagens retornadas quando ocorre um evento.

Mensagem ao criar uma transação:

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

Mensagem ao atualizar uma transação:

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

O atributo payout.id corresponde ao ID do payout sobre a qual você está sendo notificado, o parâmetro id será o identificador da notificação e o status informará sobre a criação da transação ou sua atualização.

Ações necessárias após receber a notificação

Quando você recebe uma notificação em sua plataforma, o Mercado Pago espera uma resposta para validar que essa recepção foi correta. Para isso, você deve devolver um HTTP STATUS 200 (OK) ou 201 (CREATED).

O tempo de espera para essa confirmação será de 22 segundos. Se essa confirmação não for enviada, o sistema entenderá que a notificação não foi recebida e realizará uma nova tentativa de envio a cada 15 minutos, até que receba a resposta. Após a terceira tentativa, o prazo será prorrogado, mas os envios continuarão acontecendo.

Após responder à notificação e confirmar seu recebimento, você pode obter todas as informações sobre o recurso notificado enviando um GET para o endpoint /v1/transaction-intents/{id}API.