Base de Conhecimento

Mercado Pago no n8n: receba avisos de pagamento

  • mercado pago, n8n, pagamentos, webhook, pix, automação
  • Usuários acharam útil: 0

Monte o Webhook e o HTTP Request com credenciais de teste, simule o aviso no painel, valide a x-signature e consulte o pagamento antes de liberar o pedido. Depois, vá para a produção.

Por Redação Eleven Host · @robson.direitodigital · 16 de novembro de 2026 · 9 min de leitura

Arte da Eleven Host: janela de terminal com o título: Mercado Pago no n8n: receba avisos de pagamento

Capa da Redação Eleven Host para o guia: Mercado Pago no n8n: receba avisos de pagamento Arte: Eleven Host

Usar mercado pago no n8n é receber o aviso de cada pagamento num webhook e consultar a API do Mercado Pago para saber o que aconteceu: o nó Webhook recebe a notificação, e o nó HTTP Request busca o pagamento pelo ID.

O aviso do Mercado Pago traz só o ID do pagamento. O pedido só deve ser liberado depois de consultar o pagamento na API e conferir o status.

Atualizado em 16/11/2026. Em 16/11/2026, a versão estável do n8n é a 2.47.7, publicada em 13/11/2026.

O que existe e o que falta no n8n

O núcleo do n8n não tem nó do Mercado Pago. Existe um nó da comunidade, verificado pelo n8n e mantido por parceiros do Mercado Pago, que cria link de pagamento e baixa relatórios. Ele não consulta pagamento, não gera Pix e não tem gatilho.

Para consultar pagamento, gerar Pix e receber aviso, o caminho é feito com nós nativos: o Webhook recebe a notificação e o HTTP Request chama a API.

Para quem serve

Serve para quem vende com Mercado Pago e roda o n8n na própria VPS: dar baixa em pedido pago, cobrar por Pix sob demanda ou avisar a equipe de cada venda. Para quem está começando com servidor, há o artigo sobre servidor VPS. O n8n e o Mercado Pago não fazem parte do catálogo da Eleven Host.

Os seis planos de VPS têm preço mensal na loja. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Abrir a loja

Passo 1: URL pública do n8n em HTTPS

O Mercado Pago é quem chama o seu fluxo, então o n8n precisa de uma URL pública em HTTPS. Se ele roda atrás de um proxy, defina a variável N8N_WEBHOOK_URL com o endereço público, como https://n8n.exemplo.com/, junto com N8N_PROXY_HOPS=1. A variável antiga WEBHOOK_URL está obsoleta desde o n8n 2.35.0 e gera aviso no log.

Passo 2: credenciais de teste no painel

No painel de desenvolvedores do Mercado Pago, abra Suas integrações, escolha a aplicação, mude o seletor de ambiente para Teste e abra Credenciais. Confirme que o seletor exibe o ambiente Teste antes de copiar o Access Token.

O Access Token autentica as chamadas à API e pertence ao backend; a Public Key é a do frontend. Só o Access Token entra no n8n.

Passo 3: credencial Header Auth no n8n

No n8n, crie uma credencial Header Auth, com Name igual a Authorization e Value igual a Bearer <Access Token>, trocando o trecho entre sinais pelo token de teste. A palavra Bearer e o espaço fazem parte do valor. A credencial Bearer Auth, com o campo Bearer Token, envia o mesmo cabeçalho pronto.

Mantenha o Access Token só nessa credencial, fora de URL, nó Code, nota, print, Git e chat. O Mercado Pago diz que ele nunca deve ser compartilhado nem exposto no frontend. Se vazar, renove as credenciais no painel.

Passo 4: testar a consulta com um ID conhecido

Crie um workflow com gatilho manual e um nó HTTP Request. Escolha o método GET, use a URL https://api.mercadopago.com/v1/payments/ID_DO_PAGAMENTO, trocando o final por um ID que você conheça, e em Authentication selecione Generic Credential Type com a credencial Header Auth. Execute o nó e confira o campo status na resposta.

O que a resposta traz

  • id, status (por exemplo approved) e status_detail (por exemplo accredited);
  • datas como date_created e date_approved;
  • payment_method_id, transaction_amount e currency_id;
  • payer, external_reference e metadata.

Erro 404 com o código 2000 indica pagamento não encontrado, o que acontece com ID errado ou de outro ambiente.

Passo 5: criar o nó Webhook

Adicione um nó Webhook com HTTP Method igual a POST, que é o método usado pelo aviso do Mercado Pago, e Respond igual a Immediately. Assim o n8n responde logo, e o trabalho fica para os nós seguintes. O nó mostra duas URLs: a Test URL, que só escuta depois de clicar em Listen for Test Event, e a Production URL, registrada quando o workflow é publicado.

Publique o fluxo e copie a Production URL. É ela que vai para o painel do Mercado Pago.

Passo 6: configurar as notificações

No painel, abra a aplicação, entre em Webhooks e clique em Configurar notificações. Na aba do ambiente de teste (a aba Modo produtivo é a da produção), cole a Production URL, selecione o evento Pagamentos e salve. Ao salvar, o Mercado Pago gera uma chave secreta exclusiva da aplicação, usada na validação da assinatura.

Há também o campo notification_url, enviado na criação do pagamento. Ele precisa ser HTTPS e tem prioridade sobre a URL do painel.

O formato do aviso

O corpo do aviso é um JSON com action (por exemplo payment.created ou payment.updated), api_version, data.id, date_created, id, live_mode, type e user_id. O data.id e o type também chegam na query, como data.id=123456 e type=payment. Os detalhes do pagamento vêm da consulta do passo 4.

Passo 7: simular um aviso

Pagamento de teste criado com credencial de teste não envia notificação. Para testar o Webhook, use o botão Simular do painel: escolha a URL, o tipo de evento, preencha o Data ID e clique em Enviar teste.

O Mercado Pago espera resposta 200 ou 201 em até 22 segundos. Sem ela, reenvia o aviso a cada 15 minutos, e os envios continuam, com intervalos maiores, depois da terceira tentativa. Por isso, o fluxo precisa aguentar aviso repetido: cada aviso pede uma nova consulta do pagamento e, antes de liberar um pedido, confira se ele já não foi liberado.

Passo 8: validar a x-signature

Com o nó Webhook sem autenticação, a proteção é validar o cabeçalho x-signature, no formato ts=<timestamp>,v1=<hash>, junto com o x-request-id. Sem essa validação, quem tiver a URL consegue disparar o fluxo.

Na documentação da API de Orders, o texto assinado é montado assim: id:<data.id>;request-id:<x-request-id>;ts:<ts>;. Se um dos valores não vier no aviso, esse par sai do texto. O hash é um HMAC-SHA256, em hexadecimal, calculado com a chave secreta do passo 6 e comparado com o v1 em tempo constante. O data.id usado é o da query. Recomendamos conferir no ambiente de teste se o cálculo bate com o v1 recebido.

No n8n, esse cálculo se faz num nó Code ou no nó Crypto, e um nó IF descarta o aviso que não confere. Se a chave secreta for redefinida no painel, o fluxo precisa da nova.

Passo 9: consultar o pagamento antes de agir

Depois da validação, um nó HTTP Request chama GET /v1/payments/ com o data.id do aviso, como no passo 4, e um nó IF confere se o status é approved. Só então o pedido é liberado.

Depois do teste, troque para as credenciais de produção. No painel, o ambiente é ativado em Credenciais > Produção > Ativar ambiente de produção, e o Access Token de teste dá lugar ao de produção. Atualize o Value da credencial Header Auth com o novo token e configure as notificações de novo, na aba Modo produtivo, usando na validação a chave secreta que o painel mostrar.

Exemplos para começar

Um exemplo: baixa automática. O Webhook recebe o aviso, o Code valida a assinatura, o HTTP Request consulta o pagamento, o IF confere approved e o resultado segue para a planilha ou o sistema de pedidos e para o aviso à equipe. Para a loja, veja o artigo WooCommerce no n8n: automatize pedidos da loja.

Um exemplo: cobrança por Pix sob demanda. Um HTTP Request faz POST https://api.mercadopago.com/v1/payments com payment_method_id igual a pix, transaction_amount, description e o email em payer. O cabeçalho X-Idempotency-Key vai em Send Headers, com um valor único por cobrança, como o ID do pedido, para evitar Pix duplicado numa nova tentativa. A resposta traz, em point_of_interaction.transaction_data, o qr_code (Pix copia e cola), o qr_code_base64 e o ticket_url. O vencimento padrão do Pix é de 24 horas.

Um exemplo: link de pagamento. Um HTTP Request faz POST /checkout/preferences com os itens, e o init_point da resposta é enviado ao comprador. Para planejar uma loja virtual, veja o artigo Quanto custa uma loja virtual: como montar a conta.

São exemplos de montagem, não fluxos testados. Confira o resultado no seu servidor, com as credenciais de teste.

Problemas comuns

  • O aviso não chega no teste: pagamento de teste com credencial de teste não notifica, e a saída é o botão Simular;
  • O aviso chega, mas o fluxo não vê nada: o painel precisa estar com a Production URL e o workflow publicado, porque a Test URL só escuta com Listen for Test Event;
  • Avisos repetidos: o fluxo não respondeu 200 ou 201 em 22 segundos, e o ajuste é Respond igual a Immediately;
  • Erro 401 ou 403 na API: Access Token de outro ambiente ou falta de "Bearer " no Value;
  • Pix duplicado: faltou o X-Idempotency-Key;
  • Assinatura que não confere: texto montado fora da ordem, sem o ponto e vírgula final, data.id lido do lugar errado ou chave secreta trocada.

Sobre servidores virtuais

VPS é a sigla de servidor virtual privado.

Um comparativo entre os seis planos de VPS pode ser feito na loja. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Comparar planos

Perguntas frequentes

O n8n tem nó do Mercado Pago?

No núcleo, não. Existe um nó da comunidade, verificado pelo n8n, que só cria link de pagamento e baixa relatórios. Para consultar pagamento, gerar Pix e receber aviso, use o Webhook e o HTTP Request.

O aviso do Mercado Pago traz o status do pagamento?

Não. O aviso traz o ID, e o status vem da consulta em GET /v1/payments/ com esse ID.

Um pagamento de teste comum dispara o Webhook?

Não. Pagamento de teste criado com credencial de teste não envia notificação. Use o botão Simular do painel.

Preciso de X-Idempotency-Key ao criar um Pix?

Sim, a documentação do Pix pede o atributo X-Idempotency-Key, que evita pagamento duplicado em nova tentativa.

Esta resposta lhe foi útil?

Artigos Relacionados