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-arionpayQué hace
ArionPay para Medusa
Leer más
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, 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.
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
Paso 1
Instala el paquete
Ejecuta npm install medusa-payment-arionpay en tu backend de Medusa.
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.
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.
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.
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.