Eventos de notificação

Um evento é qualquer tipo de atualização sobre o objeto notificado, incluindo mudanças de status ou atributos.

Notificamos eventos referente a seus pedidos (merchant_order) o pagamento recebido (payment).

A merchant_order é uma entidade que agrupa pagamentos aprovados ou rejeitados. Deverá consultar os dados dos pagamentos que são notificados.

Sempre que ocorrer um evento relacionado a qualquer um dos recursos mencionados, enviaremos uma notificação usando 'HTTP POST' para o notification_url que você especificou.

Os seguintes eventos são notificados:

1. Registrar o Merchant Order (MO). Ao digitalizar um QR que contém um valor, ele criará automaticamente um pedido do lojista, enviando uma notificação (se o mesmo QR for escaneado várias vezes, cada um criará um pedido comercial diferente e, portanto, uma nova notificação, a integração deve levar este cenário em consideração).
2. Atualização de pagamentos. Cada tentativa de pagamento por parte do cliente atualizará as informações do pedido do lojista e enviará uma notificação.
3. Fechamento do MO. Assim que um pagamento aprovado for realizado, o status do MO aparecerá fechado e uma notificação será enviada.

Se o servidor não estiver disponível ou demorar mais de 22 segundos para responder, o Mercado Pago tentará avisar periodicamente seguindo o seguinte esquema:

O Mercado Pago informará este notification_url ao criar e atualizar o status do pagamento ou do pedido com dois parâmetros:

Ao receber uma notificação em seu PDV, o Mercado Pago aguarda uma resposta para validar se você recebeu corretamente. Para isso, você deve retornar um HTTP STATUS 200 (OK) ou 201 (CRIADO).

Lembre-se que esta comunicação é exclusivamente entre os servidores do Mercado Pago e o seu servidor, portanto não haverá um usuário físico vendo nenhum tipo de resultado.

Se você estiver integrando pagamentos presenciais, recomendamos o uso de notificações IPN do tipo merchant_order. Para fazer isso, mantenha as seguintes regras em mente:

1. O campo status do merchant_order permanecerá aberto quando ainda não tiver pagamentos associados, ou se tiverem rejeitados ou aprovados por um valor inferior ao total do pedido.
2. O campo status do merchant_order será fechado quando a soma dos pagamentos aprovados for igual que o total do pedido.

Dentro do pedido, no objeto de pagamentos, você encontrará todos os pagamentos dele. É importante obter o id dos pagamentos com status = aproved para fazer reembolsos