As notificações Webhooks (também conhecido como retorno de chamada web) são um método simples que permite a uma aplicação ou sistema fornecer informações em tempo real sempre que um evento ocorre. É uma forma passiva de receber dados entre dois sistemas por meio de uma solicitação HTTP POST.

Uma vez configuradas, essas notificações serão enviadas sempre que uma contestação for criada ou seu status for modificado. A partir das informações recebidas, será possível gerenciar a contestação. A seguir, apresentamos um passo a passo para realizar a configuração.

1. Acesse Integrações e selecione a aplicação para a qual deseja ativar as notificações de contestações.

2. No menu lateral, selecione Configuração de Webhooks.

3. No switch Teste / Produção da parte superior, selecione Teste e insira a URL HTTPS para receber notificações de teste. Se quiser configurar notificações de produção, selecione Produção e insira a URL HTTPS de produção.

4. Nos eventos recomendados, além do evento Order (Mercado Pago) já configurado anteriormente para receber os status da transação, selecione também o evento Contestações para receber as notificações de acompanhamento das etapas da contestação. Essas notificações serão enviadas no formato JSON por meio de um HTTPS POST para a URL configurada para cada ambiente.

5. Por último, clique em Salvar. Será gerada uma assinatura secreta exclusiva para a aplicação, que permitirá validar a autenticidade das notificações recebidas e confirmar que foram enviadas pelo Mercado Pago. Para mais detalhes, consulte a documentação de Configurar notificações opcionais.

Para consultar as notificações de contestações, abra a aplicação e, em Início, selecione a aba Webhooks. Utilize o switch Teste / Produção para consultar as notificações do ambiente selecionado.

Nessa tela, você pode filtrar os envios, consultar data, status da entrega, ação, evento e ID do recurso, revisar as métricas de entrega e tempo de resposta, abrir os detalhes para visualizar o corpo da notificação e reenviá-la quando necessário. Em Teste, os dados são atualizados em tempo real.

As notificações enviadas pelo Mercado Pago para o tópico order serão semelhantes ao exemplo a seguir:

json
{
  "action": "order.charged_back",
  "api_version": "v1",
  "application_id": "1234567890123456",
  "data": {
    "external_reference": "order_pro_123",
    "id": "ORD01JRTXT3GC8CJGW394QWYQ9VP3",
    "status": "charged_back",
    "status_detail": "settled",
    "total_amount": "200.00",
    "total_paid_amount": "200.00",
    "transactions": {
      "payments": [
        {
          "id": "PAY01JRTXT3GC8CJGW394QZZ349N6",
          "amount": "200.00",
          "paid_amount": "200.00",
          "payment_method": {
            "id": "master",
            "installments": 1,
            "type": "credit_card"
          },
          "status": "charged_back",
          "status_detail": "settled",
          "reference": {
            "id": "ref-0"
          }
        }
      ],
      "chargebacks": [
        {
          "id": "CBK12JRTXT3GC8CJGW394QZZ349M7",
          "transaction_id": "PAY01JRTXT3GC8CJGW394QZZ349N6",
          "case_id": "123456789",
          "status": "settled",
          "references": ["PAY01JRTXT3GC8CJGW394QZZ349N6"]
        }
      ]
    },
    "type": "online",
    "version": 1
  },
  "date_created": "2025-04-14T19:53:23.114998555Z",
  "live_mode": false,
  "type": "order",
  "user_id": "123456789"
}

Essas notificações fornecem informações completas sobre o processo iniciado pelo cliente, sendo fundamentais para gerenciar a contestação.