Medusa-2-Zahlungsanbieter
Kryptozahlungen in Medusa annehmen
Ein Krypto-Zahlungsanbieter für Medusa 2. Kunden zahlen auf der ArionPay-Seite direkt an Ihre eigene Wallet.
Installieren
npm install medusa-payment-arionpayWas es leistet
ArionPay für Medusa
Weiterlesen
Wenn ArionPay die vollständige Zahlung bestätigt, sorgt sein signierter Webhook dafür, dass Medusa die Payment-Session autorisiert und den Warenkorb in eine Bestellung umwandelt, auch wenn der Kunde nie zurückkommt. Es ist ein Paket für Entwickler, die ihr eigenes Medusa-Backend und ihre eigene Storefront betreiben.- Auf npm als medusa-payment-arionpay veröffentlicht, ohne Abhängigkeiten außer Medusa selbst.
- Ein signierter invoice.paid-Webhook wandelt den Warenkorb in eine Bestellung um, auch wenn der Kunde nie zurückkommt.
- Wenn die Storefront den Warenkorb abschließt, fragt der Anbieter direkt bei ArionPay nach, sodass ein verlorener Webhook abgefangen wird.
- Eine Session gilt nur dann als bezahlt, wenn ArionPay selbst die Rechnung mit demselben Betrag, derselben Währung und demselben Modus bestätigt.
- Ändert sich der Warenkorb, erhält die nächste Session eine neue Rechnung über den neuen Gesamtbetrag.
- Kryptozahlungen sind endgültig, daher wird die Zahlung sofort erfasst (captured).
- testMode ist aktiv, solange Sie es nicht auf false setzen, sodass eine fehlende Einstellung nie echtes Geld einnimmt.
Voraussetzungen und Lizenz
- Funktioniert mit
- Medusa 2 · Node 20 oder neuer
- Getestet
- Medusa 2.22.7 mit Node 22 und PostgreSQL 16: 21 Prüfungen über die Store API plus 7 Unit-Tests
- Kosten
- Das Plugin ist kostenlos. ArionPay berechnet 0,5 % pro Zahlung, ohne Monatsgebühr.
- Quellcode
- Open Source (MIT) auf GitHub.
Einrichtung
In 5 Schritten eingerichtet
Schritt 1
Paket installieren
Führen Sie in Ihrem Medusa-Backend npm install medusa-payment-arionpay aus.
Schritt 2
Anbieter registrieren
Fügen Sie in medusa-config.ts dem Payment-Modul medusa-payment-arionpay/providers/arionpay mit der id arionpay hinzu. Tragen Sie Ihre drei ArionPay-Schlüssel und die Adresse Ihres Backends in .env ein.
Schritt 3
Zu Ihren Regionen hinzufügen
Starten Sie Medusa neu, öffnen Sie in der Verwaltung Settings > Regions und fügen Sie ArionPay (pp_arionpay_arionpay) jeder Region hinzu, die Krypto anbieten soll.
Schritt 4
Storefront anpassen
Erstellen Sie die Payment-Session mit einer return_url, leiten Sie den Kunden zu session.data.invoice_url und schließen Sie den Warenkorb ab, wenn er zurückkommt.
Schritt 5
Erst testen, dann live gehen
Der Testmodus mit Spielgeld bleibt aktiv, bis Sie ARIONPAY_TEST_MODE auf false setzen. Prüfen Sie, dass „Old ArionPay (v1) integration compatibility“ in den Einstellungen Ihres ArionPay-Shops ausgeschaltet ist.
Nach der Einrichtung
So ändern sich Bestellungen
- Wenn ArionPay die vollständige Zahlung bestätigt, sorgt sein signierter Webhook dafür, dass Medusa die Payment-Session autorisiert und den Warenkorb in eine Bestellung umwandelt.
- Kryptozahlungen sind endgültig, daher wird die Zahlung sofort erfasst (captured).
- Wenn die Storefront den Warenkorb abschließt, fragt der Anbieter direkt bei ArionPay nach. Ein Warenkorb, der bereits eine Bestellung ist, liefert diese Bestellung zurück.
- Ändert sich der Warenkorb nach dem Erstellen der Session, erhält die nächste Session eine neue Rechnung über den neuen Gesamtbetrag.
- Eine nicht exakte Zahlung geht an Payment Radar. Eine kleine Abweichung innerhalb der Zahlungstoleranz Ihres Shops (Standard 1 %) wird automatisch akzeptiert; über alles andere entscheiden Sie. Verspätete Zahlungen schließen die Bestellung trotzdem ab.
- Die Session-Daten halten die bezahlte Rechnung, den Coin und Hinweise wie paid_late oder underpaid_within_tolerance fest.
16 Coins und Token in 9 Netzwerken
Alle Coins- BTCBitcoin
- ETHEthereum
- USDTEthereum
- USDCEthereum
- BNBBNB Smart Chain
- USDTBNB Smart Chain
- USDCBNB Smart Chain
- POLPolygon
- USDTPolygon
- USDCPolygon
- TRXTRON
- USDTTRON
- LTCLitecoin
- DOGEDogecoin
- BCHBitcoin Cash
- DASHDash
Fragen zu ArionPay für Medusa
Kurze Antworten, bevor Sie es installieren.