Ir al contenido
ArionPay

Proveedor de pago para Medusa 2

Acepta pagos en cripto en Medusa

Un proveedor de pago en cripto para Medusa 2. Los clientes pagan en la página de ArionPay, directamente a tu propia billetera.

Instalar

npm install medusa-payment-arionpay
Código fuente en GitHub
Ejemplo

Qué hace

ArionPay para Medusa

medusa-payment-arionpay es un proveedor de pago en cripto para Medusa 2. Tu storefront envía al cliente a la página de ArionPay y el dinero va directo a tu propia billetera: ArionPay nunca lo custodia.
Leer másCuando ArionPay confirma el pago completo, su webhook firmado hace que Medusa autorice la sesión de pago y convierta el carrito en un pedido, aunque el cliente no vuelva nunca. Es un paquete para desarrolladores que gestionan su propio backend y storefront de Medusa.
  • Publicado en npm como medusa-payment-arionpay, sin más dependencias que el propio Medusa.
  • Un webhook invoice.paid firmado convierte el carrito en un pedido, aunque el cliente no vuelva nunca.
  • Cuando el storefront completa el carrito, el proveedor consulta directamente a ArionPay, así que se detecta un webhook perdido.
  • Una sesión solo cuenta como pagada cuando el propio ArionPay confirma la factura con el mismo importe, la misma moneda y el mismo modo.
  • Si el carrito cambia, la siguiente sesión recibe una factura nueva por el nuevo total.
  • Los pagos en cripto son definitivos, así que el pago se captura de inmediato.
  • testMode está activado salvo que lo pongas en false, así que un ajuste olvidado nunca cobra dinero real.
Ejemplo

Requisitos y licencia

Funciona con
Medusa 2 · Node 20 o posterior
Probado
Medusa 2.22.7 con Node 22 y PostgreSQL 16: 21 comprobaciones a través de la Store API, más 7 pruebas unitarias
Precio
El plugin es gratuito. ArionPay cobra un 0.5% por pago, sin cuota mensual.
Código fuente
Código abierto (MIT) en GitHub.

Configuración

Configúralo en 5 pasos

Configuración: medusa-config.ts y .env, y luego Settings > Regions en la administración de Medusa
  1. Paso 1

    Instala el paquete

    Ejecuta npm install medusa-payment-arionpay en tu backend de Medusa.

  2. Paso 2

    Registra el proveedor

    En medusa-config.ts, añade medusa-payment-arionpay/providers/arionpay al módulo de pagos con el id arionpay. Pon tus tres claves de ArionPay y la dirección de tu backend en .env.

  3. Paso 3

    Añádelo a tus regiones

    Reinicia Medusa, abre Settings > Regions en la administración y añade ArionPay (pp_arionpay_arionpay) a cada región que deba ofrecer cripto.

  4. Paso 4

    Actualiza el storefront

    Crea la sesión de pago con un return_url, envía al cliente a session.data.invoice_url y completa el carrito cuando vuelva.

  5. Paso 5

    Prueba y luego cobra de verdad

    El modo de prueba con dinero ficticio sigue activado hasta que pongas ARIONPAY_TEST_MODE en false. Comprueba que Old ArionPay (v1) integration compatibility esté desactivada en la configuración de tu tienda en ArionPay.

Después de la configuración

Cómo cambian los pedidos

  • Cuando ArionPay confirma el pago completo, su webhook firmado hace que Medusa autorice la sesión de pago y convierta el carrito en un pedido.
  • Los pagos en cripto son definitivos, así que el pago se captura de inmediato.
  • Cuando el storefront completa el carrito, el proveedor consulta directamente a ArionPay. Un carrito que ya es un pedido devuelve ese pedido.
  • Si el carrito cambia después de crear la sesión, la siguiente sesión recibe una factura nueva por el nuevo total.
  • Un pago que no es exacto va a Payment Radar. Una pequeña diferencia dentro de la tolerancia de pago de tu tienda (1% de forma predeterminada) se acepta automáticamente; en todo lo demás, decides tú. Los pagos tardíos también completan el pedido.
  • Los datos de la sesión registran la factura pagada, la moneda y notas como paid_late o underpaid_within_tolerance.

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 ArionPay para Medusa

Respuestas breves antes de la instalación.

Medusa 2. Se probó en Medusa 2.22.7 con Node 22 y PostgreSQL 16.