Nó Pagar.me

O nó de workflow Pagar.me cria um pedido pela Core API v5 do Pagar.me. Suporta PIX, cartão de crédito, boleto e pagamentos com múltiplos métodos configurados no array payments.

ID do nó no editor: pagarme_transaction
Endpoint da API: POST https://api.pagar.me/core/v5/orders

O que faz

• Cria um pedido com itens, cliente e configuração de pagamento
• Retorna o id do pedido, status e array charges com detalhes da transação
• Autentica com Basic auth usando API key codificada em Base64

Pré-requisitos

1. Uma conta Pagar.me (adquirente Stone)
2. Secret API key em Dashboard → Configurações → API Keys
3. Chave de integração pagarme_api_key_base64 em Configurações → Chaves de API

O nó espera a API key já codificada em Base64 para autenticação Basic (Authorization: Basic {{pagarme_api_key_base64}}). Codifique your_secret_key: (com dois-pontos no final) em Base64.

Como configurar

Etapa 1 — Preparar credenciais Base64

O Pagar.me v5 usa autenticação Basic. Codifique sua secret key:

Base64(secret_key + ":")

Exemplo: se sua chave é sk_abc123, codifique sk_abc123: em Base64.

Armazene o resultado no WhatsWave:

1. Configurações → Chaves de API
2. Adicione chave de integração:
   • Nome: pagarme_api_key_base64
   • Valor: a string Base64 (não a secret key bruta)

Etapa 2 — Adicionar o nó

Arraste Pagar.me de Payments para o canvas do workflow.

Etapa 3 — Configurar os campos

Exemplo de items:

[
  {
    "amount": 15000,
    "description": "Service package",
    "quantity": 1
  }
]

Exemplo de customer:

{
  "name": "{{contact.name}}",
  "email": "{{contact.email}}",
  "document": "{{variables.customer_cpf}}",
  "type": "individual"
}

Exemplo de payments — somente PIX:

[
  {
    "payment_method": "pix",
    "pix": {
      "expires_in": 3600
    }
  }
]

Exemplo de payments — cartão de crédito (com token do frontend):

[
  {
    "payment_method": "credit_card",
    "credit_card": {
      "card_token": "{{variables.card_token}}",
      "installments": 1
    }
  }
]

Dados de cartão devem ser tokenizados no cliente com Pagar.me JS — nunca passe números de cartão brutos pelos workflows.

Etapa 4 — Usar a saída de charges

Inspecione charges na saída da execução para QR code PIX, URL de boleto ou status da transação:

Payment status: {{pagarme_1.status}}

Use um nó JavaScript para extrair last_transaction.qr_code_url do PIX se necessário.

Etapa 5 — Webhooks

Registre webhooks do Pagar.me para order.paid, charge.paid, etc., apontando para um workflow Webhook do WhatsWave.

Saídas do nó

Dicas e boas práticas

• Valores em centavos em itens e valores de pagamento
• Pré-codifique credenciais Base64 uma vez — não armazene secret keys brutas em variáveis de workflow
• Use PIX com expires_in para QR codes com tempo limitado
• Para boleto, inclua endereço válido do cliente se exigido pela sua configuração Pagar.me
• Teste com chaves de sandbox do Pagar.me antes da produção
• A soma dos valores dos itens deve coincidir com o valor do pagamento para evitar erros de validação
• Use idempotência via metadados únicos de pedido na descrição do cliente ou do item

Exemplos de casos de uso

Link de pagamento PIX no WhatsApp

1. Webhook com total do pedido e CPF do cliente
2. Pagar.me — método de pagamento PIX, expiração de 1 hora
3. JavaScript — extrair URL do QR code de charges
4. Enviar WhatsApp — imagem ou texto com código PIX

Pedido com múltiplos itens do e-commerce

1. Webhook do Shopify/WooCommerce
2. Variable — mapear linhas do carrinho para o formato de items do Pagar.me
3. Pagar.me — cliente + items + PIX
4. Workflow de confirmação no webhook order.paid

FAQ

Por que 401 Unauthorized?
O valor Base64 está incorreto. Certifique-se de codificar secret_key: (com dois-pontos), não apenas a chave.

Posso passar a API key bruta em vez de Base64?
O template do nó usa autenticação Basic. Armazene o valor pré-codificado em pagarme_api_key_base64.

Como obtenho o QR code PIX?
Verifique charges[0].last_transaction na saída completa da execução — os campos variam conforme a versão da API.

Cartão de crédito sem token?
Não é suportado com segurança. Use checkout Pagar.me ou SDK de tokenização no seu site.

Referência da API

Relacionados

• Visão geral de pagamentos
• Webhooks recebidos
• Nó JavaScript