Inicio
Documentação
Recursos
Parcerias
Comunidade

Parcerias

Conheça nosso programa para agências ou desenvolvedores que oferecem serviços de integração e vendedores que desejam contratá-los.

Comunidade

Fique por dentro das últimas novidades, peça ajuda a outros integradores e compartilhe seu conhecimento.

Notificações - Suas integrações - Mercado Pago Developers
Qual documentação você quer buscar?

Não sabe como começar a integrar? 

Acesse os primeiros passos

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:

EventosNome em Suas integraçõesTópicoProdutos associados
Criação e atualização de pagamentosPagamentospaymentCheckout API
Checkout Pro
Checkout Bricks
Assinaturas
Mercado Pago Point (somente para IPN)
Wallet Connect
Pagamento recorrente de uma assinatura (criação - atualização)Planos e assinaturassubscription_authorized_paymentAssinaturas
Vinculação de uma assinatura (criação - atualização)Planos e assinaturassubscription_preapprovalAssinaturas
Vinculação de um plano de assinatura (criação - atualização)Planos e assinaturassubscription_preapproval_planAssinaturas
Vinculação e desvinculação de contas que se conectaram através de OAuthVinculação de aplicaçõesmp-connectTodos os produtos que tenham OAuth implementado
Finalização, cancelamento ou erros ao processar intenções de pagamento de dispositivos Mercado Pago Point.Integrações Pointpoint_integration_wh / point_integration_ipnMercado Pago Point
Transações com Wallet ConnectWallet Connectwallet_connectWallet Connect
Alertas de fraude após o processamento de um pedidoAlertas de fraudestop_delivery_op_wh / delivery_cancellationCheckout API
Checkout Pro
Criação de estornos e reclamaçõesReclamaçõestopic_claims_integration_whCheckout API
Checkout Pro
Checkout Bricks
Assinaturas
Mercado Pago Point
Código QR
Wallet Connect
Recuperação e atualização de informações de cartões no Mercado PagoCard Updatertopic_card_id_whCheckout Pro
Checkout API
Checkout Bricks
Criação, fechamento ou expiração de ordens comerciais.Ordens comerciaistopic_merchant_order_wh / merchant_orderCheckout Pro
Código QR
Abertura de chargebacks, mudanças de status e modificações referentes às liberações de dinheiroChargebackstopic_chargebacks_wh / chargebacksCheckout Pro
Checkout API
Checkout Bricks
Criação, atualização ou cancelamento de pedidos.Delivery (proximity marketplace)deliveryMP Delivery

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.

TipoDescrição
WebhooksRecomendadas. 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.
IPNPermite 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.