Package Exports
- n8n-nodes-pagbank-connect
- n8n-nodes-pagbank-connect/index.js
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (n8n-nodes-pagbank-connect) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
n8n-nodes-pagbank-connect
Integração do n8n com PagBank Connect para processamento de pagamentos brasileiros.
Características
- ✅ PIX - Pagamentos instantâneos com QR Code
- ✅ Cartão de Crédito/Débito - Processamento seguro de cartões
- ✅ Boleto - Boletos bancários para pagamento
- ✅ Links de Pagamento - Checkout personalizado
- ✅ Assinaturas Recorrentes - Pagamentos recorrentes (em breve)
- ✅ Webhooks - Notificações em tempo real
- ✅ Ambiente Sandbox - Testes seguros
- ✅ Parceiro Oficial - PagBank Integrações é parceiro Oficial PagBank desde 2014.
- ✅ Taxas reduzidas - Você paga menos taxas no PagBank ao usar nossas integrações
Instalação
npm install n8n-nodes-pagbank-connectConfiguração
1. Obter Credenciais
Acesse PagBank Connect para obter sua Connect Key Gratuitamente
Se precisar de uma Connect Key de Testes, clique aqui.
2. Configurar no n8n
- Adicione sua Connect key nas credenciais do PagBank Connect
- Clique em Salvar e veja se a conexão foi realizada com sucesso.
Nós Disponíveis
PagBank (Principal)
- Criar Link de Pagamento - Gera links de checkout para o cliente pagar no PagBank
- Criar Pedido PIX - Cria pagamentos PIX
- Criar Cobrança Cartão - Processa um pagamento com o cartão de crédito e dados informados
- Consultar status do pedido - Consulta o status de um ORDER junto ao PagBank (deve ter sido gerado com esta connect key)
- Validar Connect Key - Valida Connect Key configurada em suas credenciais
PagBank Webhook
- Webhook de Pagamento - Recebe notificações. É possível filtrar por notificações por status de pagamento, meios de pagamento ou motivo de negação.
Outras informações úteis
Formato dos Dados
Valores Monetários
Todos os valores são em centavos:
- R$ 10,00 = 1000
- R$ 1,50 = 150
CPF/CNPJ
- CPF: 11 dígitos (apenas números)
- CNPJ: 14 dígitos (apenas números)
Obrigatório para a maioria das operações, exceto criação de link de pagamento.
Ambientes
Sandbox (Teste)
- O ambiente será de testes sempre que sua Connect Key começar com CONSANDBOX. Obtenha a sua aqui.
- Aprovação automática para valores < R$ 100
- Delay de 5 minutos para valores entre R$ 100-200
- Ideal para desenvolvimento e testes
- Veja Cartões de teste
Produção
- Processamento real de pagamentos
- Requer aprovação do PagBank
- Use apenas após testes completos
Webhooks
Configuração
- Configure a URL do webhook no n8n
- Adicione a URL gerada no campo URL de Notificação ao criar pagamentos e links de pagamento nas demais ações
- Configure filtros por status e método de pagamento
- Certifique-se que a URL pode ser acessada de fora sem nenhum bloqueio.
Erros Comuns
- **40002 - Email do comprador igual ao vendedor
- **40002 - CPF/CNPJ inválido
- **40002 - Telefone inválido
- **UNAUTHORIZED - Connect Key inválida
Validações
- CPF/CNPJ são validados automaticamente
- Telefones são formatados
Suporte
- Site Oficial: pbintegracoes.com/n8n
- Documentação: PagBank Integrações
- Issues e Suporte: Abra um Chamado
Licença
MIT License - veja o arquivo LICENSE para detalhes.
Contribuição
- Fork o projeto no github
- Crie uma branch para sua feature/bugfix
- Commit suas mudanças
- Push para a sua branch local
- Abra um Pull Request para a branch
develop
Changelog
v1.0.0
- Lançamento inicial
- Suporte a PIX, Cartão, Boleto
- Links de pagamento
- Webhooks
Roadmap
- Mais opções de parcelamento
- Venda recorrente
Sujeito à alteração conforme solicitações da comunidade.