Guía en video de n8n
Conecta n8n a una pasarela de pagos en cripto
Crea facturas en cripto desde cualquier flujo de trabajo de n8n y ejecuta tus propios pasos cuando se confirme un pago. Mira toda la configuración en menos de tres minutos y luego sigue los seis pasos. Los clientes pagan directamente a tu propia billetera.
En n8n: Settings › Community Nodes › Install, y luego escribe
n8n-nodes-arionpayMíralo en acción
n8n y ArionPay, de la instalación a un pedido pagado
Instala el nodo, conecta tus claves, recibe una actualización de pago firmada y mira cómo se rechaza una falsificada. Elige un capítulo para saltar a él.
Una sola toma en un n8n 1.123.96 autoalojado con un servidor de prueba local de ArionPay, en modo de prueba: sin dinero real. Sin sonido; los subtítulos están en la imagen, y cada paso se describe por escrito más abajo.
Antes de empezar
Lo que necesitas
- Una cuenta de ArionPay: para registrarte solo necesitas una dirección de correo electrónico. Crea una gratis.
- Un n8n autoalojado que permita nodos de la comunidad. Probado en n8n 1.123.96 (Node.js 22), aún no en n8n 2.x.
- Tu clave de API, tu secreto de API y tu secreto de firma de webhook, del panel de ArionPay.
- Para pagos reales, tu propia billetera conectada en el panel. Las facturas de prueba no necesitan dinero real.
Paso a paso
Conecta n8n a ArionPay en seis pasos
- 1
Instala el nodo
En n8n, abre Settings › Community nodes y haz clic en Install. Escribe n8n-nodes-arionpay, confirma el aviso sobre el código de la comunidad e instálalo.
n8n descarga el paquete desde npm y añade un nodo: ArionPay. El paquete no tiene otras dependencias.
- 2
Añade tus credenciales de la API
Crea una credencial del tipo ArionPay API y pega la clave de API, el secreto de API y el secreto de firma de webhook de tu panel de ArionPay. Deja ArionPay Address como está: https://merchant.arionpay.com.
Al guardar, n8n prueba las claves con una solicitud firmada que no cambia nada. En el video, primero se rechaza un secreto incorrecto y luego el correcto muestra “Connection tested successfully”.
- 3
Crea el flujo de trabajo que recibe los pagos
Añade el nodo Webhook propio de n8n: HTTP Method POST, Respond “When Last Node Finishes”, Response Data “No Response Body”, y en Options añade Raw Body y actívalo.
Después, añade ArionPay › Webhook › Verify Webhook y elige los eventos que quieras (Invoice Paid de forma predeterminada). Luego añade tus propios pasos: enviar el archivo, dar acceso o marcar el pedido como pagado.
Activa el flujo de trabajo y copia la Production URL del nodo Webhook en la página Webhooks de tu panel de ArionPay, o envíala como Callback URL con cada factura.
- 4
Crea una factura de prueba y págala
En cualquier flujo de trabajo, ArionPay › Invoice › Create crea una factura: el importe y la divisa, Test Invoice activado y, en Additional Fields, la moneda cripto, tu ID de pedido y la URL de callback.
ArionPay responde con la factura, incluida su página de pago (invoiceUrl): ahí es adonde envías a tu cliente. En modo de prueba, ArionPay › Invoice › Simulate Test Payment la paga con dinero ficticio.
- 5
Llega el webhook de pago
ArionPay firma una actualización invoice.paid y la envía a tu flujo de trabajo. Verify Webhook la comprueba y la deja pasar una sola vez, aunque ArionPay la entregue de nuevo.
Tu siguiente paso encuentra todo lo que necesita: invoice.orderId para el pedido, invoice.amountFiat e invoice.currency para lo que se pagó, invoice.paidCrypto e invoice.asset para la moneda, e invoice.transactions[0].txid para la transacción en la blockchain. En el video, un nodo Set marca el pedido ORDER-1001 como pagado.
- 6
Se rechaza un webhook falsificado
Tu dirección de webhook es pública, así que cualquiera puede enviarle un “invoice.paid” inventado. Verify Webhook comprueba la firma HMAC sobre el cuerpo exacto con tu secreto de firma, y también la marca de tiempo.
En el video, una actualización falsificada con una firma incorrecta se detiene en Verify Webhook con “Invalid signature”. Los pasos siguientes nunca se ejecutan, y el pedido no se marca como pagado.
Después de la configuración
Cómo llegan las actualizaciones de pago
- “Invoice Paid” significa pagada por completo y confirmada. Eso incluye los pagos tardíos, las pequeñas diferencias dentro de la tolerancia de pago de tu tienda (1% de forma predeterminada) y los pagos que aceptaste en Payment Radar.
- Un pago que no es exacto nunca llega como pagado hasta que tú decidas en el panel.
- Una actualización que no supera la verificación (secreto de firma incorrecto, firma incorrecta o antigua) hace fallar el flujo de trabajo, así que ArionPay la vuelve a enviar más tarde, durante unos 3 días.
- Los eventos que no elegiste terminan el flujo de trabajo discretamente con una respuesta 200.
- Los eventos “Send test webhook” del panel describen una factura inventada y se omiten salvo que los actives.
- Antes de entregar, comprueba invoice.amountFiat e invoice.currency, y que invoice.test sea false en las ventas reales.
Por qué ArionPay
Lo que obtienes
Cobrado en tu propia billetera
Los clientes pagan directamente a tu billetera. ArionPay nunca custodia el dinero, así que no hay saldo que retirar.
Actualizaciones firmadas, verificadas automáticamente
Verify Webhook comprueba cada actualización de pago y deja pasar cada evento una sola vez. Las solicitudes falsificadas o repetidas se detienen ahí.
Primero, modo de prueba
Crea y prueba todo el flujo de trabajo con facturas de prueba y pagos simulados, y luego pasa a los reales.
Cualquier paso siguiente
Envía un correo al cliente, añade una fila a una hoja de cálculo, da acceso o publica en un chat: todo lo que n8n pueda hacer. ArionPay cobra el 0.5% por pago.
El nodo es de código abierto (MIT). Código fuente en GitHub Descargar el video (6.6 MB)
16 monedas y tokens en 9 redes
Todas las monedas- BTCBitcoin
- ETHEthereum
- USDTEthereum
- USDCEthereum
- BNBBNB Smart Chain
- USDTBNB Smart Chain
- USDCBNB Smart Chain
- POLPolygon
- USDTPolygon
- USDCPolygon
- TRXTRON
- USDTTRON
- LTCLitecoin
- DOGEDogecoin
- BCHBitcoin Cash
- DASHDash
Preguntas sobre n8n y ArionPay
n8n Cloud, pruebas, monedas y precio.





