Skip to main content

n8n

Integre a Beehive com o n8n para automatizar fluxos e criar rotinas.
 O node da BeehiveHub para n8n permite integrar o gateway de pagamentos da plataforma diretamente aos seus fluxos de automação. Com ele, você pode automatizar cobranças, consultar transações, cadastrar clientes, criar transferências, consultar saldo e gerar links de pagamento sem sair do n8n.
Esta página mostra como instalar e usar o node. Para detalhes completos dos campos aceitos em cada operação, consulte também a referência da API.

​
Instalação

Você pode instalar o node da BeehiveHub pela interface do n8n ou via npm em ambientes self-hosted.

​
Pela interface do n8n

  1. Abra sua instância do n8n
  2. Vá em Settings
  3. Acesse Community Nodes
  4. Clique em Install
  5. Informe o pacote abaixo:
@paybeehive/n8n-nodes-beehivehub

​
Via npm

npm install @paybeehive/n8n-nodes-beehivehub

​
Credenciais

Para usar este node, você precisa de uma BeehiveHub API Secret Key.

​
Como obter sua chave

  1. Faça login no dashboard da paybeehive
  2. Vá até as configurações da conta ou seção de API Keys
  3. Copie sua Secret Key

​
Como configurar no n8n

  1. No n8n, vá em Credentials
  2. Clique em Create Credential
  3. Procure por BeehiveHub API
  4. Cole sua Secret Key
  5. Clique em Save
O node usa HTTP Basic Auth internamente. A secret key é enviada como usuário, e a senha é ignorada pela API.

​
Operações disponíveis

​
Transaction

  • Create: cria uma nova transação (pix, boleto ou credit_card)
  • Get: consulta uma transação por ID
  • Get Many: lista transações com filtros
  • Refund: realiza reembolso total ou parcial
  • Update Delivery Status: atualiza o status de entrega da transação

​
Customer

  • Create: cadastra um novo cliente
  • Get: consulta um cliente por ID
  • Get Many: lista clientes

​
Transfer

  • Create: cria uma transferência
  • Get: consulta uma transferência por ID

​
Balance

  • Get Available: consulta o saldo disponível
  • Create: cria um link de pagamento
  • Get: consulta um link por ID
  • Get Many: lista todos os links
  • Update: atualiza um link existente
  • Delete: remove um link

​
Como usar

Depois de instalar o pacote e configurar a credencial:
  1. Crie ou abra um workflow no n8n
  2. Adicione o node BeehiveHub
  3. Escolha o recurso desejado, como Transaction, Customer, Transfer, Balance ou Payment Link
  4. Selecione a operação
  5. Preencha os campos necessários
  6. Execute o node para testar a integração

​
Valores em centavos

Todos os valores monetários devem ser enviados em centavos. Exemplos:
  • 1000 = R$ 10,00
  • 4990 = R$ 49,90

​
Métodos de pagamento aceitos

Ao criar uma transação, o campo paymentMethod aceita os seguintes valores:
  • pix
  • boleto
  • credit_card

​
Compatibilidade

  • n8n: versão mínima 1.0
  • Node.js: v22 ou superior
  • n8n API version: 1 em modo strict
O pacote foi testado em n8n self-hosted. A compatibilidade com n8n Cloud depende da verificação de community nodes.

​
Uso com IA no n8n

Este node é marcado como usableAsTool, o que permite utilizá-lo como ferramenta em fluxos com n8n AI Agent. Isso é útil para cenários em que um agente precisa, por exemplo:
  • criar uma cobrança automaticamente
  • consultar uma transação
  • buscar saldo
  • gerar um link de pagamento como parte de um fluxo inteligente

​
Casos de uso

O node da BeehiveHub é indicado para fluxos como:
  • receber dados de formulário e gerar cobrança
  • consultar pagamentos automaticamente
  • cadastrar clientes sem ação manual
  • gerar links de pagamento para enviar em outros canais
  • integrar a operação financeira com CRM, planilhas, e-mail ou automações internas

​
Exemplo de fluxo

Um fluxo simples com n8n pode seguir esta lógica:
  1. Receber um formulário ou webhook
  2. Criar uma transação Pix
  3. Armazenar a resposta em uma planilha ou CRM
  4. Enviar o link ou QR Code para o cliente

​
Observações importantes

  • Use sempre sua Secret Key correta no ambiente desejado
  • Revise os campos obrigatórios conforme o recurso selecionado
  • Para payloads mais detalhados, combine esta página com a referência da API
  • Em transações com cartão, siga o fluxo seguro de tokenização antes do envio para a API

​
Recursos úteis

  • Documentação da API da paybeehive
  • Documentação de Community Nodes do n8n
  • Fórum da comunidade n8n