Nesta documentação, você encontrará informações adicionais sobre notificações, incluindo considerações especiais conforme a solução integrada, aspectos específicos de certos tópicos e exemplos de notificações específicas para consulta.

Card Updater é uma função para integrações de produtos com pagamentos recorrentes, que corrige dados de cartões expirados ou com informações incorretas, atualizando essas informações dentro do Mercado Pago.

Este processo ocorre a partir de um pagamento recusado, onde a verificação feita pelo Card Updater pode gerar um novo card_id para um cliente (em casos de erro na inserção de dados ou troca de cartão), ou manter o card_id previamente criado, mas atualizando a base de dados com as informações corretas do cartão.

Em qualquer um dos casos, será enviada uma notificação Webhooks como no exemplo abaixo.

{
  "action": "card.updated",
  "api_version": "v1",
  "application_id": 8339021212080291,
  "data": {
    "customer_id": "12345678-aluyasdhfyt",
    "new_card_id": 50000102202,
    "old_card_id": 50000006036
  },
  "date_created": "2024-01-11T15:23:53-03:00",
  "id": "a47fc06844bf4e418a03aeab1479c496",
  "live_mode": true,
  "type": "automatic-payments",
  "user_id": 1197520450,
  "version": 1
}

Este tópico permite receber notificações sobre a atualização dos status nas intenções de pagamento criadas para integrações Point. Ao ativá-lo, considere as informações descritas abaixo:

• "Intenção de pagamento" e "pagamento" não são a mesma coisa. Ao ativar este tópico, você receberá atualizações sobre as solicitações criadas para iniciar um pagamento. Para receber notificações sobre o pagamento em si, ative o tópico payments através de Suas integrações.
• Não é possível configurar este tópico no momento da criação de um pagamento. Sua configuração deve ser feita através de Suas integrações.
• É possível consultar as notificações correspondentes aos diferentes status das intenções de pagamento acessando a documentação específica do Mercado Pago Point.

Para ativar as notificações da sua integração com Assinaturas, considere as informações descritas abaixo:

• Se você integrou Assinaturas com planos associados, ative o tópico subscription_preapproval_plan para receber alertas sobre a criação ou atualização de um Plano.
• Se você integrou Assinaturas sem planos associados, ative o tópico subscription_preapproval para receber alertas sobre a criação ou atualização de uma assinatura de pagamento pendente, ou o tópico subscription_authorized_payment para atualizações sobre assinaturas com pagamento autorizado.
• Em todos os casos, também é necessário ativar o tópico payments, que permite receber notificações sobre os pagamentos associados a essas assinaturas quando forem efetuados.

Se você integrou com o Checkout Pro e deseja receber notificações, considere as informações descritas abaixo:

• A ativação do tópico merchant_orders permitirá receber alertas sobre a criação e atualizações de pedidos.
• A ativação do tópico payments será útil para manter sua base de dados atualizada, pois notificará sobre as atualizações nos pagamentos correspondentes aos pedidos gerados.

Caso seja detectado um alerta de fraude e o tópico stop_delivery_op_wh estiver ativado, você receberá uma notificação como a seguinte:

{
    "action": "Created",
    "api_version": "v1",
    "data": {
        "description": "desc",
        "merchant_order": 249940988000,
        "payment_id": 58980959081,
        "site_id": "MLA"
    },
    "date_created": "2022-07-23T23:03:5704:00",
    "id": "58980959081",
    "live_mode": true,
    "type": "stop_delivery_op_wh",
    "user_id": 224403329,
    "version": 1
}

A notificação inclui os detalhes do pedido que gerou o alerta, sob o parâmetro merchant_order, e o payment_id associado ao pagamento. Com esses dados, deve-se cancelar o pedido sem entregá-lo, realizando uma chamada à API de cancelametos.

Tenha em mente que esse tipo de notificação não segue a lógica usual de tentativas. Se, ao recebê-la, você não enviar um HTTP STATUS 200 (OK) ou 201 (CREATED), a notificação será perdida e não será reenviada.

Nos casos em que as notificações para o tópico topic_claims_integration_wh estiverem ativadas, uma notificação Webhooks será enviada quando um reclamação ou chargeback for iniciado, conforme mostrado abaixo:

{
    "action": "Created",
    "api_version": "v1",
    "data": {
        "description": "desc",
        "merchant_order": 249940988000,
        "payment_id": 58980959081,
        "site_id": "MLA"
    },
    "date_created": "2022-07-23T23:03:5704:00",
    "id": "58980959081",
    "live_mode": true,
    "type": "stop_delivery_op_wh",
    "user_id": 224403329,
    "version": 1
}

Nos casos em que as notificações para o tópico topic_chargebacks_wh estiverem ativadas, uma notificação Webhooks será enviada quando um chargeback for iniciado, ou seu status atualizado, conforme mostrado abaixo:

{
    "actions":["changed_case_status"],
    "api_version":"v1",
    "application_id":9007201037432480,
    "data":{
        "checkout":"PRO",
        "date_updated":"0001-01-01T00:00:00Z",
        "id":217000061307271000,
        "payment_id":81034165129,
        "product_id":"BC32A57TRPP001U8NHHG",
        "site_id":"MLA",
        "transaction_intent_id":""
        },
    "date_created":"2024-07-02T22:03:24-04:00",
    "id":114544942708,
    "live_mode":true,
    "type":"topic_chargebacks_wh",
    "user_id":425424311,
    "version":1720427447
}

Se você integrou meios de pagamento offline e configurou suas notificações com o tópico payments, todas as mudanças de status de um pagamento serão notificadas a você.

Isso também é válido para pagamentos expirados: seu status mudará de pending para cancelled, e o alerta correspondente será enviado ao seu sistema.

Se você integrou com código QR e deseja receber notificações, considere o seguinte:

• Para Webhooks, não é possível configurar notificações através de Suas integrações. Você deve fazê-lo no momento da criação do pagamento.
• Portanto, não é possível validar a origem das notificações usando o header x-Signature. Para conhecer vias alternativas para verificar a origem dessas notificações, você pode entrar em contato com o Suporte do Mercado Pago.
• A ativação do tópico merchant_orders permitirá que você receba alertas sobre a criação e atualizações de pedidos. Embora o tópico envie um status=opened, será a notificação com status=closed que certificará com segurança que o pedido gerado foi pago.

A seguir, mostramos um exemplo de notificação para o tópico Delivery, juntamente com as descrições de cada campo notificado.

{
    _id: "f9f08571-1f65-4c46-9e0a-c0f43faas1557e",
    topic: "delivery",
    resource: "/shipments/12345",
    user_id: 1793791954,
    application_id: "924152943338358",
    sent: "2021-11-01T02:02:02.002Z",
    attempts: 1,
    received: "2021-11-01T02:02:02.002Z",
    actions: []
}

Ao receber uma notificação deste tópico, confirme o recebimento retornando um HTTP STATUS 200 (OK) dentro de até 500 ms. Caso contrário, o sistema continuará tentando enviar novas notificações a cada 12 horas.

Não é possível configurar notificações para Links de pagamento gerados através do Painel do Mercado Pago.