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 Suas integrações e selecione a aplicação integrada com Checkout API para a qual deseja ativar as notificações.

2. No menu à esquerda, selecione Webhooks > Configurar notificações.

3. Em "URL de produção", configure a URL HTTPS produtiva que será utilizada para receber as notificações.

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. Estas notificações serão enviadas no formato JSON por meio de um HTTPS POST para a URL especificada anteriormente.

5. Por último, clique em Salvar configurações. Isso gerará uma chave secreta exclusiva para a aplicação, que permitirá validar a autenticidade das notificações recebidas, garantindo que elas tenham sido enviadas pelo Mercado Pago. Para mais detalhes, consulte a documentação de notificações de Webhooks.

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

json
Copiar
{
  "action": "order.charged_back",
  "api_version": "v1",
  "application_id": "874202490252970",
  "data": {
    "external_reference": "ext_ref_1234",
    "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": "PAY01JT4211RXR4678HH8304SDKW4",
          "case_id": "123456789",
          "status": "settled",
          "amount": "200.00",
          "references": [
             {
               "id": "01JSZZW4Q2JZJZC1R1W08KRVEP"
             }
           ]
        }
      ],
    },
    "type": "online",
    "version": 1
  },
  "date_created": "2025-04-14T19:53:23.114998555Z",
  "live_mode": false,
  "type": "order",
  "user_id": "2021490138"
}

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