Pagos cripto en n8n
Un nodo de la comunidad de n8n para SnapEX Pay. Crea facturas cripto desde cualquier flujo de trabajo y lanza un flujo cuando se paga una factura. Los clientes pagan en USDT (TRC20, ERC20, BEP20) u otras monedas compatibles en la página de SnapEX Pay; el trigger verifica la firma de cada webhook y puede volver a leer la factura desde la API antes de que tu flujo continúe.
Gratis. Versión 1.1.0.
Qué hace
- Nodo de acción SnapEX Pay (también utilizable como herramienta de un agente de IA): Create Invoice devuelve
invoice_id,statusypay_url; Get Invoice devuelve la factura actual. - Cada petición de creación lleva una
Idempotency-Key; con un External ID, un reintento devuelve la misma factura en lugar de crear una segunda. - SnapEX Pay Trigger lanza un flujo con
invoice.paid(por defecto) y otros eventos de factura; los eventos que no seleccionaste se confirman y se ignoran. - El trigger comprueba la firma HMAC-SHA256, rechaza marcas de tiempo con más de 5 minutos de desfase y responde 401 a una firma incorrecta, así que no se ejecuta ningún flujo. Con Re-Fetch Invoice activado, la factura se vuelve a leer desde la API.
- Sin dependencias en tiempo de ejecución.
Environment = testpara pagos simulados que nunca mueven fondos.
Instalación
- En la carpeta de nodos de n8n (
~/.n8n/nodes, en Docker/home/node/.n8n/nodes) ejecutanpm install https://pay.snapex.pro/downloads/n8n/n8n-nodes-snapex-pay-1.1.0.tgzy reinicia n8n. - Crea una credencial SnapEX Pay API: la clave API del panel de SnapEX Pay → Developers (permisos
invoices.readeinvoices.write). El botón Test del diálogo de credenciales comprueba la clave y su permisoinvoices.read. - Añade SnapEX Pay Trigger a un flujo, elige los eventos y copia la Production URL del nodo.
- En el panel → Developers → Webhook pega esa URL y guarda, y luego copia el secreto
whsec_…en el campo Webhook Secret de la credencial. - Activa el flujo. Constrúyelo con
Environment = test; entrega los productos solo cuandoinvoice.statusseapaid.
Ajustes
| API Key | Panel de SnapEX Pay → Developers → Merchant API key, permisos invoices.read e invoices.write. |
|---|---|
| Webhook Secret | El secreto whsec_… que se muestra una sola vez, al guardar por primera vez la URL del webhook en el panel. Solo lo necesita el trigger. |
| Create Invoice | Amount USD (el mínimo lo fija SnapEX Pay), External ID, Description, Success y 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 de la credencial: el Partner ID del integrador que configuró el nodo (programa de referidos de SnapEX Pay). Déjalo vacío si lo instalas tú mismo. |
Preguntas
¿Está el nodo en el registro de npm?
Todavía no. Instálalo desde el archivo de esta página con npm install <archive URL> en la carpeta de nodos de n8n.
¿Cómo evito entregar dos veces?
SnapEX Pay reintenta una entrega que no recibió una respuesta 2xx, así que haz la entrega idempotente con webhook_id o invoice_id, y entrega solo cuando invoice.status sea paid.
¿Puedo usarlo en un agente de IA?
Sí. El nodo de acción SnapEX Pay se puede usar como herramienta de un agente de IA.
¿Por qué falla la activación?
El trigger necesita el Webhook Secret en la credencial; si falta, la activación falla con un mensaje claro.
Otras integraciones
¿Listo para aceptar cripto?
Crea una cuenta de comercio, obtén una clave API y conecta el módulo. 1% por pago, sin cuota mensual.