Notificações
As notificações são mensagens enviadas pelo servidor do Mercado Pago a partir de eventos realizados em sua aplicação. Para que essas notificações sejam enviadas, é necessário ativar diferentes tópicos de notificação, seja em Suas integrações ou ao criar um pagamento. Isso permitirá que você obtenha informações sobre os diferentes eventos ocorridos.
A ativação desses tópicos dependerá da solução do Mercado Pago que foi integrada e das necessidades de negócio, conforme mostrado na tabela a seguir:
Eventos | Nome em Suas integrações | Tópico | Produtos associados |
Criação e atualização de pagamentos | Pagamentos | payment | Checkout API Checkout Pro Checkout Bricks Assinaturas Wallet Connect |
Pagamento recorrente de uma assinatura (criação - atualização) | Planos e assinaturas | subscription_authorized_payment | Assinaturas |
Vinculação de uma assinatura (criação - atualização) | Planos e assinaturas | subscription_preapproval | Assinaturas |
Vinculação de um plano de assinatura (criação - atualização) | Planos e assinaturas | subscription_preapproval_plan | Assinaturas |
Vinculação e desvinculação de contas que se conectaram através de OAuth | Vinculação de aplicações | mp-connect | Todos os produtos que tenham OAuth implementado |
Transações com Wallet Connect | Wallet Connect | wallet_connect | Wallet Connect |
Alertas de fraude após o processamento de um pedido | Alertas de fraude | stop_delivery_op_wh / delivery_cancellation | Checkout API Checkout Pro |
Criação de estornos e reclamações | Reclamações | topic_claims_integration_wh | Checkout API Checkout Pro Checkout Bricks Assinaturas Código QR Wallet Connect |
Recuperação e atualização de informações de cartões no Mercado Pago | Card Updater | topic_card_id_wh | Checkout Pro Checkout API Checkout Bricks |
Criação, fechamento ou expiração de ordens comerciais. | Ordens comerciais | topic_merchant_order_wh / merchant_order | Checkout Pro Código QR |
Abertura de chargebacks, mudanças de status e modificações referentes às liberações de dinheiro | Chargebacks | topic_chargebacks_wh / chargebacks | Checkout Pro Checkout API Checkout Bricks |
Após configuradas, as notificações permitem programar o backend da sua loja para diversas ações, como: atualizar o status de pedidos quando um pagamento é criado, enviar um e-mail de confirmação quando um pedido é atualizado no Mercado Pago, atualizar o cadastro de um cliente quando um plano de assinatura é vinculado, entre outras ações conforme os eventos detalhados na tabela acima.
Existem dois tipos de notificações disponíveis para configuração, como detalhado na tabela abaixo.
Tipo | Descrição |
Webhooks | Recomendadas. Utiliza HTTP REST para notificar instantaneamente as atualizações e oferece maior segurança na integração por meio de uma assinatura secreta. Este método de validação garante que as notificações recebidas são enviadas pelo Mercado Pago. Para saber como configurar e simular o envio dessas notificações, leia a documentação de Webhooks. |
IPN | Permite que sua aplicação receba notificações do Mercado Pago sobre o status de um pagamento, chargeback ou merchant order, por meio de uma chamada HTTP POST. Tenha em mente que a notificação pode demorar alguns instantes para ser enviada e não permite realizar a validação mediante o header x-Signature .Importante: As notificações IPN serão descontinuadas em breve. Por isso, recomendamos a utilização das notificações Webhooks. |