Saltar al contenido
Iniciar sesiónRegistrarse

Acepta pagos cripto con la pasarela de pagos Medusa

Te alcanza una cuenta de Cryptonly y una API key. Instala el plugin, actívalo en una región y tu tienda Medusa puede cobrar en cripto. Los pasos de abajo son toda la configuración.

Cómo empezar a aceptar pagos cripto en Medusa

  1. Crea una cuenta de Cryptonly

    Abre una cuenta de comercio en el panel de Cryptonly. Esa cuenta emite la API key, el id de cuenta y la clave de firma del webhook que usan los pasos de abajo.

  2. Genera una API key

    Crea una clave que pueda crear, listar y cancelar facturas: invoices.create, invoices.list e invoices.cancel. Guarda la clave, el id de cuenta y la clave de firma del webhook para la configuración de Medusa.

  3. Instala el plugin de Medusa

    Agrega el proveedor de pagos de Cryptonly a tu app de Medusa y registra @cryptonly/medusa-plugin-cryptonly/providers/cryptonly en medusa-config.ts con la API key, el id de cuenta y la clave de firma del webhook. El ejemplo de configuración está en la guía de integración de Medusa.

    npm install @cryptonly/medusa-plugin-cryptonly

  4. Empieza a cobrar

    Activa Cryptonly en una región desde el admin de Medusa. El cliente paga en la página alojada y el webhook firmado captura la sesión de pago en Medusa cuando el pago se confirma.

  5. Conecta el storefront

    En el checkout, llama a initiatePaymentSession y redirige al cliente al paymentPageUrl que devuelve Cryptonly. Paga en la página alojada y vuelve a tu tienda.

¿Qué es Medusa?

Medusa es un framework de comercio de código abierto para Node.js. Una tienda hecha con él usa un backend headless y un storefront que te pertenece, en lugar de un tema alojado.

Pagos, regiones y fulfillment son módulos. En Medusa v2 una pasarela es un proveedor de pagos: lo registras y después lo activas en las regiones donde debe ofrecerse.

Cryptonly usa ese hook de proveedor. Los precios se quedan en la moneda de tu tienda. El cliente paga en una página de Cryptonly y un webhook firmado captura la sesión en Medusa cuando el pago se confirma.

¿Qué cripto puedes aceptar con Medusa y Cryptonly?

Ver todas las criptomonedas
BitcoinBTCUSD 82,746.01-0.46%EthereumETHUSD 2,531.44+0.97%TetherUSDTUSD 0.999001-0.01%USD CoinUSDCUSD 1.001+0.01%BNBBNBUSD 746.60-0.46%TRONTRXUSD 0.3312+0.24%ChainlinkLINKUSD 13.033-0.67%

Preguntas sobre Medusa

  • ¿Qué versiones de Medusa soporta el plugin?

    Medusa v2.8 o posterior, sobre Node.js 20 o posterior. El proveedor se engancha al módulo de pagos de Medusa, así que las apps v1 no están soportadas.

  • ¿Tengo que armar una página de checkout cripto?

    No. El cliente paga en una página alojada de Cryptonly y vuelve a tu tienda. No construyes una pantalla de wallet ni vigilas la cadena.

  • ¿Cuánto cuesta?

    0.5% por pago, sin tarifa de alta.

  • ¿Puedo probar el plugin antes de cobrar de verdad?

    Sí. El modo sandbox recorre la página alojada y el webhook sin mover fondos. Lo apagas cuando quieras aceptar pagos reales.

  • ¿Los precios de los productos tienen que estar en cripto?

    No. El catálogo se queda en la moneda de tu tienda. Cryptonly convierte el monto cuando el cliente paga.

  • ¿Cómo se entera Medusa de que un pedido está pagado?

    Cryptonly envía un webhook firmado a tu backend. El proveedor verifica la firma y Medusa captura la sesión de pago.

Acepta pagos cripto con Medusa y Cryptonly

Checkout alojado, webhooks firmados y una comisión del 0.5%. Medusa mantiene el estado del pedido al día y tu catálogo sigue en fiat.