Nó MercadoPago

O nó de workflow MercadoPago cria um pagamento pela API de Pagamentos do Mercado Pago. Use-o para PIX, cartão de crédito, boleto e outros métodos habilitados na sua conta Mercado Pago.

ID do nó no editor: mercadopago_payment
Endpoint da API: POST https://api.mercadopago.com/v1/payments

O que faz

• Cria um pagamento com valor, descrição, dados do pagador e método de pagamento
• Retorna o id do pagamento, status e status_detail
• Autentica com seu Access Token do Mercado Pago (Produção ou Teste)

Pré-requisitos

1. Uma conta de desenvolvedor Mercado Pago
2. Access Token das credenciais da sua aplicação (Teste ou Produção)
3. Chave de integração mercadopago_access_token em Configurações → Chaves de API

Como configurar

Etapa 1 — Adicionar o nó

1. Abra seu workflow em Automações
2. Em Payments, arraste MercadoPago para o canvas
3. Conecte-o após o gatilho ou nós de dados do cliente

Etapa 2 — Definir credenciais

1. No Mercado Pago → Suas integrações → selecione seu app → Credenciais
2. Copie o Access Token (Teste para desenvolvimento, Produção para live)
3. No WhatsWave Configurações → Chaves de API, adicione:
   • Nome: mercadopago_access_token
   • Valor: seu Access Token

Etapa 3 — Configurar os campos

Exemplo de payer:

{
  "email": "{{contact.email}}",
  "first_name": "{{contact.name}}",
  "identification": {
    "type": "CPF",
    "number": "{{variables.customer_cpf}}"
  }
}

Exemplo com variáveis para o valor:

• Amount: {{variables.order_total}}
• Description: Order #{{trigger.body.order_id}}

Etapa 4 — Tratar a resposta

O Mercado Pago retorna campos diferentes conforme o método de pagamento. Para PIX, a resposta pode incluir dados de QR code no corpo completo ({{mercadopago_1.data}} ou inspecione a saída da execução).

Adicione um nó Send message para enviar as instruções de pagamento:

Your payment of R$ {{variables.order_total}} was created. Status: {{mercadopago_1.status}}

Para QR codes PIX, você pode precisar de um nó JavaScript ou Variable para extrair point_of_interaction.transaction_data.qr_code da resposta e enviá-lo como texto ou imagem.

Etapa 5 — Testar

1. Use credenciais de Teste do Mercado Pago
2. Execute o workflow manualmente com dados de pagador de exemplo
3. Verifique os logs de execução para status e status_detail
4. Troque para token de Produção ao ir para live

Saídas do nó

A resposta completa da API fica disponível na saída de execução do nó em data para campos aninhados (código PIX copia e cola, URL do boleto, etc.).

Notificações de pagamento

Configure webhooks/IPN do Mercado Pago para notificar o WhatsWave quando o status do pagamento mudar:

1. Crie um workflow com gatilho Webhook
2. Registre a URL do webhook nas configurações de notificação do Mercado Pago
3. No status approved, envie confirmação via WhatsApp e atualize o CRM

Dicas e boas práticas

• Use usuários e cartões de teste da documentação do Mercado Pago antes da produção
• Sempre envie um e-mail válido do pagador — o Mercado Pago exige isso para muitos métodos de pagamento
• Para PIX, prefira Checkout Pro ou Payment Brick se precisar de página hospedada; este nó é melhor para criação de pagamento server-side
• Armazene external_reference adicionando via um nó HTTP anterior ou estendendo metadados do pagador com IDs de pedido na descrição
• Idempotência: evite criar pagamentos duplicados em retentativas de webhook — use Condition para verificar se o pagamento já existe
• O valor deve respeitar os mínimos do Mercado Pago para o método selecionado

Exemplos de casos de uso

Pagamento PIX após webhook de pedido

1. Webhook — plataforma de e-commerce envia total do pedido e CPF do cliente
2. Variable — normalizar formato do CPF
3. MercadoPago — valor do pedido, pagador do contato, método pix
4. Enviar WhatsApp — código PIX copia e cola extraído da resposta

Link de pagamento manual para equipe de vendas

1. Gatilho Manual com variável de valor
2. MercadoPago — criar pagamento
3. Send message para {{contact.phone}} com status e instruções

FAQ

Por que recebo invalid access_token?
O token expirou, foi revogado ou foi copiado do ambiente errado (Teste vs Produção).

Qual a diferença entre tokens de Teste e Produção?
Tokens de teste criam pagamentos em sandbox; tokens de produção cobram dinheiro real. Nunca misture os dois.

Posso criar assinaturas com este nó?
Este nó usa /v1/payments. Para assinaturas, use a API Preapproval do Mercado Pago via nó HTTP genérico ou endpoints dedicados de assinatura.

Por que o status é pending?
Normal para PIX e boleto até o cliente pagar. Aguarde a notificação do webhook antes de marcar o pedido como pago.

Quais valores de payment_method_id são válidos?
Depende do país da conta e dos métodos habilitados. Consulte Payment methods.

Referência da API

Relacionados

• Visão geral de pagamentos
• Webhooks recebidos
• Variáveis em workflows