Como automatizo pagamentos com o n8n?
No seu n8n autogerenciado, instale o pacote n8n-nodes-selectwin, crie a credencial Selectwin API com a sua chave e use os nós Selectwin e Selectwin Trigger.
Atualizado em
O pacote n8n-nodes-selectwin traz dois nós para o n8n: Selectwin, que faz operações na API da Selectwin, e Selectwin Trigger, que começa um fluxo quando algo acontece na sua conta. O pacote ainda está em versão inicial. O passo a passo completo, com todas as operações, está na documentação do n8n.
Antes de começar
O pacote roda no seu próprio n8n: o autogerenciado (self-hosted), com os nós da comunidade habilitados. No n8n Cloud, ele ainda não está disponível.
Instalar
- No seu n8n, vá em Settings → Community Nodes → Install.
- Digite
n8n-nodes-selectwine confirme.
Criar a credencial
- No n8n, crie uma credencial Selectwin API.
- Em API Key, cole a sua chave:
sk_test_para testar,sk_live_para produção. Veja onde pegar as chaves. - Deixe o Base URL como está.
Reagir a eventos
- Adicione o nó Selectwin Trigger e escolha os eventos em Events.
- Ative o fluxo. O nó cadastra sozinho um webhook na sua conta e confere a assinatura de cada entrega: o que não vier assinado pela Selectwin é recusado antes de chegar ao fluxo.
- Ao desativar o fluxo, o webhook é removido.
O endereço do seu n8n precisa ser público e em https. Se ele gerar um endereço http, o nó mostra um erro e não ativa. Enquanto o fluxo está ativo, o webhook aparece na Workbench, em Webhooks, no ambiente da chave.
Fazer operações
No nó Selectwin, escolha o recurso em Resource — Transaction, Customer, Product, Payment Link, Subscription, Balance, entre outros — e a operação. Dá para criar cobranças em Pix ou boleto, cadastrar clientes e produtos, gerar links de pagamento e consultar saldo, recebíveis e saques. Para o que o nó ainda não cobre, use a credencial Selectwin API no nó HTTP Request do próprio n8n.
Veja também
- Onde pego as chaves de API e como testo no sandbox?Em Configurações → Desenvolvedores. Para testar, mude o painel para Sandbox e gere uma chave sk_test_: a URL da API é a mesma, só a chave muda.
- Como aceito chamadas da API só de alguns IPs?Em Configurações → Desenvolvedores, em IPs que podem usar a API, ligue Aceitar a API só destes IPs e adicione os IPs ou as faixas dos seus servidores. Chamadas de outro IP são recusadas.
- Como configuro webhooks no painel?Na Workbench, aba Webhooks, clique em Criar endpoint, informe uma URL https e escolha os eventos. Guarde o segredo de assinatura e use Enviar teste para conferir.
Ainda precisa de ajuda?
Fale com o seu gerente de conta pelo WhatsApp ou e-mail, de segunda a sexta, das 8h às 18h.