Zum Inhalt springen
ArionPay

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-arionpay
Quellcode auf GitHub
Beispiel

Was es leistet

ArionPay für Medusa

medusa-payment-arionpay ist ein Medusa-2-Zahlungsanbieter für Krypto. Ihre Storefront leitet den Kunden zur ArionPay-Seite, und das Geld geht direkt an Ihre eigene Wallet: ArionPay verwahrt es nie.
WeiterlesenWenn 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.
Beispiel

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

Einstellungen: medusa-config.ts und .env, dann Settings > Regions in der Medusa-Verwaltung
  1. Schritt 1

    Paket installieren

    Führen Sie in Ihrem Medusa-Backend npm install medusa-payment-arionpay aus.

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

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

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

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

Medusa 2. Getestet wurde er mit Medusa 2.22.7, Node 22 und PostgreSQL 16.