Pagamentos em cripto no n8n
Um community node do n8n para a SnapEX Pay. Crie faturas em cripto em qualquer workflow e dispare um workflow quando uma fatura for paga. Os clientes pagam em USDT (TRC20, ERC20, BEP20) ou em outras moedas aceitas, na página da SnapEX Pay; o trigger verifica a assinatura HMAC de cada webhook e pode reler a fatura na API antes de o seu workflow seguir.
Grátis. Versão 1.1.0.
O que faz
- Node de ação SnapEX Pay (também pode ser usado como ferramenta de um agente de IA): Create Invoice retorna
invoice_id,statusepay_url; Get Invoice retorna a fatura atual. - Toda requisição de criação inclui um
Idempotency-Key; com um External ID, uma nova tentativa retorna a mesma fatura em vez de criar uma segunda. - O SnapEX Pay Trigger dispara um workflow em
invoice.paid(padrão) e em outros eventos de fatura; eventos que você não selecionou são aceitos e ignorados. - O trigger verifica a assinatura HMAC-SHA256, rejeita timestamps com mais de 5 minutos de diferença e responde 401 a uma assinatura inválida, então nenhum workflow é executado. Com Re-Fetch Invoice ativado, a fatura é relida na API.
- Sem dependências em tempo de execução.
Environment = testpara pagamentos simulados, que nunca movimentam dinheiro.
Instalação
- Na pasta de nodes do n8n (
~/.n8n/nodes, no Docker/home/node/.n8n/nodes), executenpm install https://pay.snapex.pro/downloads/n8n/n8n-nodes-snapex-pay-1.1.0.tgze reinicie o n8n. - Crie uma credencial SnapEX Pay API: a chave de API do painel da SnapEX Pay → Desenvolvedores (escopos
invoices.readeinvoices.write). O botão Test na janela da credencial verifica a chave e o escopoinvoices.read. - Adicione o SnapEX Pay Trigger a um workflow, escolha os eventos e copie a Production URL do node.
- No painel → Desenvolvedores → Webhook, cole essa URL e salve; depois copie a chave secreta
whsec_…para o campo Webhook Secret da credencial. - Ative o workflow. Monte o workflow com
Environment = test; entregue o produto só quandoinvoice.statusforpaid.
Configurações
| API Key | Painel da SnapEX Pay → Desenvolvedores → chave de API do comerciante, escopos invoices.read e invoices.write. |
|---|---|
| Webhook Secret | A chave secreta whsec_…, exibida uma única vez, quando você salva a URL do webhook no painel pela primeira vez. Necessária só para o trigger. |
| Create Invoice | Amount USD (o mínimo é definido pela SnapEX Pay), External ID, Description, Success e Cancel URL, Fee Paid By, Environment, Expires In (1–1440 minutos). |
| Trigger events | invoice.paid, invoice.partially_paid, invoice.underpaid, invoice.expired, invoice.extra_payment, invoice.created, invoice.awaiting. |
| Partner ID | Campo opcional da credencial: o Partner ID do integrador que configurou o node (programa de indicações da SnapEX Pay). Deixe em branco se você mesmo fez a configuração. |
Perguntas
O node está no registro do npm?
Ainda não. Instale a partir do arquivo compactado desta página com npm install <archive URL> na pasta de nodes do n8n.
Como evitar entregar o pedido duas vezes?
A SnapEX Pay reenvia a entrega que não recebeu uma resposta 2xx; por isso, torne a entrega idempotente com webhook_id ou invoice_id e entregue só quando invoice.status for paid.
Posso usar em um agente de IA?
Sim. O node de ação SnapEX Pay pode ser usado como ferramenta de um agente de IA.
Por que a ativação falha?
O trigger precisa do campo Webhook Secret preenchido na credencial; se ele estiver vazio, a ativação falha com uma mensagem clara.
Outras integrações
Pronto para receber em cripto?
Crie uma conta de comerciante, gere uma chave de API e conecte o módulo. 1% por pagamento, sem mensalidade.