Mercado Pago

Por Que Mercado Pago?

Mercado Pago e o maior processador de pagamentos da America Latina. Aceita PIX, cartoes, boleto e tem taxas competitivas. Essencial para qualquer negocio brasileiro.

PIX

Pagamento instantaneo com QR Code

Cartao

Credito e debito com parcelamento

Boleto

Boleto bancario tradicional

Link de Pagamento

Cobre sem precisar de site

1

Criar Aplicacao

Portal de Desenvolvedores

1. Acesse mercadopago.com.br/developers
2. Faca login com sua conta Mercado Pago
3. Va em Suas integracoes → Criar aplicacao
4. Preencha nome (ex: "N8N Automacao")
5. Escolha tipo: Checkout Pro ou Checkout Transparente

Diferenca

Checkout Pro: Cliente vai para pagina do MP (mais simples)
Checkout Transparente: Pagamento no seu site (mais customizavel)

2

Obter Credenciais

Access Token e Public Key

1. Na sua aplicacao, va em Credenciais de producao
2. Copie o Access Token (comeca com APP_USR)
3. Copie tambem a Public Key (para frontend)

Ambiente de Teste

Use as Credenciais de teste para desenvolvimento. Crie usuarios de teste em Contas de teste.

Formato das credenciais:

// Producao
Access Token: APP_USR-1234567890123456-...

// Teste
Access Token: TEST-1234567890123456-...

3

Configurar Webhooks

Notificacoes IPN (Instant Payment Notification)

1. Na aplicacao, va em Webhooks
2. Cole a URL do seu N8N Webhook
3. Selecione os eventos:

Evento	Quando Dispara
payment	Pagamento criado, aprovado, recusado, etc
merchant_order	Pedido atualizado
chargebacks	Contestacao de pagamento
point_integration_wh	Pagamentos Point (maquininha)

4

Usar no N8N

Via HTTP Request (nao tem node nativo)

Importante

N8N nao tem node nativo do Mercado Pago. Use o HTTP Request.

Configuracao padrao:

// HTTP Request - Header Authentication

Header Name: Authorization
Header Value: Bearer APP_USR-seu-access-token

Base URL: https://api.mercadopago.com

Exemplos Praticos

1. Criar pagamento PIX

// HTTP Request: POST
URL: https://api.mercadopago.com/v1/payments

Body:
{
  "transaction_amount": 100.00,
  "payment_method_id": "pix",
  "payer": {
    "email": "cliente@email.com",
    "first_name": "Joao",
    "last_name": "Silva",
    "identification": {
      "type": "CPF",
      "number": "12345678909"
    }
  }
}

// Resposta contem:
// point_of_interaction.transaction_data.qr_code (texto)
// point_of_interaction.transaction_data.qr_code_base64 (imagem)

2. Processar webhook de pagamento

// Webhook Trigger: Recebe notificacao MP
// → HTTP Request: GET detalhes do pagamento

URL: https://api.mercadopago.com/v1/payments/{{ $json.data.id }}

// → Switch: Verifica status
approved: Pagamento confirmado → Liberar produto
pending: Aguardando pagamento
rejected: Pagamento recusado → Notificar cliente

3. Criar link de pagamento

// HTTP Request: POST
URL: https://api.mercadopago.com/checkout/preferences

Body:
{
  "items": [
    {
      "title": "Curso N8N",
      "quantity": 1,
      "unit_price": 297.00
    }
  ],
  "back_urls": {
    "success": "https://seusite.com/sucesso",
    "failure": "https://seusite.com/erro"
  },
  "auto_return": "approved"
}

// Resposta: init_point (URL de pagamento)

4. Consultar saldo da conta

// HTTP Request: GET
URL: https://api.mercadopago.com/users/me

// Resposta inclui:
// available_balance: saldo disponivel para saque
// total_balance: saldo total (inclui pendentes)

5. Reembolso total

// HTTP Request: POST
URL: https://api.mercadopago.com/v1/payments/{{ $json.payment_id }}/refunds

// Body vazio = reembolso total
// Ou especifique amount para reembolso parcial:
{
  "amount": 50.00
}

Status de Pagamento

Status	Significado	Acao
approved	Pagamento aprovado	Liberar produto/servico
pending	Aguardando pagamento	Aguardar (PIX, boleto)
in_process	Em analise	Aguardar aprovacao
rejected	Recusado	Pedir outra forma de pagamento
cancelled	Cancelado	Nenhuma
refunded	Devolvido	Dinheiro retornou ao cliente

Taxas

Metodo	Taxa	Liberacao
PIX	0,99%	Instantaneo
Credito a vista	4,98%	14 dias
Credito parcelado	4,98% + parcelas	Conforme parcelas
Debito	1,99%	14 dias
Boleto	R$ 3,49	3 dias uteis

Nota: Taxas podem variar. Contas com alto volume podem negociar taxas menores.

Dicas Importantes

Sempre valide webhook

Ao receber IPN, sempre faca GET no pagamento para confirmar dados. Nunca confie apenas no webhook (pode ser forjado).

Idempotencia

Use o header X-Idempotency-Key para evitar criar pagamentos duplicados em caso de retry.

Teste com usuarios de teste

Crie usuarios de teste no painel. Use cartoes de teste fornecidos pelo MP para simular aprovacao/recusa.

PIX expira

Por padrao, PIX expira em 24h. Use date_of_expiration para definir prazo customizado.