Aller au contenu
ArionPay

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-arionpay
Code source sur GitHub
Exemple

Fonctionnalités

ArionPay pour Medusa

medusa-payment-arionpay est un fournisseur de paiement crypto pour Medusa 2. Votre storefront redirige le client vers la page ArionPay, et l’argent arrive directement sur votre propre portefeuille : ArionPay ne le détient jamais.
En savoir plusQuand 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.
Exemple

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

Paramètres : medusa-config.ts et .env, puis Settings > Regions dans l’admin Medusa
  1. Étape 1

    Installer le package

    Lancez npm install medusa-payment-arionpay dans votre backend Medusa.

  2. É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.

  3. É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.

  4. É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.

  5. É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.

Medusa 2. Il a été testé sur Medusa 2.22.7 avec Node 22 et PostgreSQL 16.