Fournisseur de paiement Medusa 2
Acceptez les paiements crypto dans Medusa
Un fournisseur de paiement crypto pour Medusa 2. Vos clients paient sur la page ArionPay, directement sur votre propre portefeuille.
Installer
npm install medusa-payment-arionpayFonctionnalités
ArionPay pour Medusa
En savoir plus
Quand ArionPay confirme le paiement complet, son webhook signé amène Medusa à autoriser la session de paiement et à transformer le panier en commande, même si le client ne revient jamais. C’est un package destiné aux développeurs qui gèrent leur propre backend et leur propre storefront Medusa.- Publié sur npm sous le nom medusa-payment-arionpay, sans autre dépendance que Medusa lui-même.
- Un webhook invoice.paid signé transforme le panier en commande, même si le client ne revient jamais.
- Quand le storefront finalise le panier, le fournisseur interroge directement ArionPay : un webhook perdu est donc rattrapé.
- Une session n’est considérée comme payée que lorsqu’ArionPay confirme lui-même la facture pour le même montant, la même devise et le même mode.
- Si le panier change, la session suivante reçoit une nouvelle facture pour le nouveau total.
- Les paiements crypto sont définitifs : le paiement est donc capturé immédiatement.
- testMode est activé tant que vous ne le réglez pas sur false : un réglage manquant ne prend donc jamais d’argent réel.
Prérequis et licence
- Compatible avec
- Medusa 2 · Node 20 ou plus récent
- Testé
- Medusa 2.22.7 avec Node 22 et PostgreSQL 16 : 21 vérifications via la Store API, plus 7 tests unitaires
- Coût
- Le plugin est gratuit. ArionPay prélève 0,5 % par paiement, sans frais mensuels.
- Code source
- Open source (MIT) sur GitHub.
Installation
Mise en place en 5 étapes
Étape 1
Installer le package
Lancez npm install medusa-payment-arionpay dans votre backend Medusa.
Étape 2
Enregistrer le fournisseur
Dans medusa-config.ts, ajoutez medusa-payment-arionpay/providers/arionpay au module de paiement avec l’id arionpay. Mettez vos trois clés ArionPay et l’adresse de votre backend dans .env.
Étape 3
L’ajouter à vos régions
Redémarrez Medusa, ouvrez Settings > Regions dans l’admin et ajoutez ArionPay (pp_arionpay_arionpay) à chaque région qui doit proposer la crypto.
Étape 4
Mettre à jour le storefront
Créez la session de paiement avec un return_url, envoyez le client vers session.data.invoice_url, et finalisez le panier à son retour.
Étape 5
Tester, puis passer en production
Le mode test avec de l’argent fictif reste activé tant que vous ne réglez pas ARIONPAY_TEST_MODE sur false. Vérifiez que l’option « Old ArionPay (v1) integration compatibility » est désactivée dans les paramètres de votre boutique ArionPay.
Après la configuration
Comment évoluent les commandes
- Quand ArionPay confirme le paiement complet, son webhook signé amène Medusa à autoriser la session de paiement et à transformer le panier en commande.
- Les paiements crypto sont définitifs : le paiement est donc capturé immédiatement.
- Quand le storefront finalise le panier, le fournisseur interroge directement ArionPay. Un panier déjà transformé en commande renvoie cette commande.
- Si le panier change après la création de la session, la session suivante reçoit une nouvelle facture pour le nouveau total.
- Un paiement inexact arrive dans Payment Radar. Un petit écart compris dans la tolérance de paiement de votre boutique (1 % par défaut) est accepté automatiquement ; pour tout le reste, c’est vous qui décidez. Les paiements en retard finalisent quand même la commande.
- Les données de session enregistrent la facture payée, la crypto et des notes comme paid_late ou underpaid_within_tolerance.
16 cryptos et jetons sur 9 réseaux
Toutes les cryptos- BTCBitcoin
- ETHEthereum
- USDTEthereum
- USDCEthereum
- BNBBNB Smart Chain
- USDTBNB Smart Chain
- USDCBNB Smart Chain
- POLPolygon
- USDTPolygon
- USDCPolygon
- TRXTRON
- USDTTRON
- LTCLitecoin
- DOGEDogecoin
- BCHBitcoin Cash
- DASHDash
Questions sur ArionPay pour Medusa
Des réponses courtes avant de l’installer.