Ir al contenido
ArionPay

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.

Ver el video (2:28)Empieza gratis

En n8n: Settings › Community Nodes › Install, y luego escribe

n8n-nodes-arionpay
Ejemplo

Mí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. 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.

    Settings de n8n, Community nodes: n8n-nodes-arionpay versión 2.0.0 instalado, con un nodo, ArionPay
  2. 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”.

    La credencial de la cuenta de ArionPay en n8n con la clave de API, el secreto de API y el secreto de firma de webhook, mostrando Connection tested successfully
  3. 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.

    Un flujo de trabajo activo de n8n: Webhook, luego Verify ArionPay webhook y luego Mark order as paid
  4. 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.

    El nodo Create invoice de ArionPay en n8n: 25 USD, factura de prueba, moneda USDT en TRON, con la nueva factura y su invoiceUrl en la salida
  5. 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.

    n8n después del webhook de pago: el evento invoice.paid verificado a la izquierda, y el pedido ORDER-1001 marcado como pagado con 25 USDT y el ID de la transacción
  6. 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.

    n8n detiene un webhook falsificado en Verify ArionPay webhook con el error: Not a valid ArionPay webhook: Invalid signature

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.

Todavía no. n8n Cloud solo ofrece los nodos de la comunidad que n8n ha verificado, y hemos enviado el nodo de ArionPay para su verificación. Mientras tanto, usa un n8n autoalojado, donde se puede instalar cualquier nodo de la comunidad.