Zum Inhalt springen
ArionPay

Node.js-/TypeScript-Bibliothek

Kryptozahlungen in Ihrer Node.js-App annehmen

Erstellen Sie eine Krypto-Rechnung von Ihrem Node.js-Server aus, leiten Sie den Kunden zur ArionPay-Zahlungsseite und prüfen Sie den signierten Webhook, wenn er zahlt. Das Geld geht direkt an Ihre eigene Wallet.

Installieren

npm install arionpay
Quellcode auf GitHub
Beispiel

Was es leistet

ArionPay für Node.js-Entwickler

arionpay ist der offizielle ArionPay-Client für Node.js. Er erstellt und liest Rechnungen und prüft die Signatur jedes Webhooks auf dem Raw Body, bevor Sie ihm vertrauen.
WeiterlesenEr hat keine Abhängigkeiten, enthält ESM- und CommonJS-Builds mit TypeScript-Typen und läuft auf Node.js 18 oder neuer. ArionPay verwahrt das Geld nie: Jede Zahlung geht direkt an Ihre eigene Wallet.
  • Keine Abhängigkeiten. Node.js 18 oder neuer.
  • ESM und CommonJS, mit TypeScript-Typen.
  • Jede Rechnungsanfrage enthält einen Idempotency-Key, sodass ein Netzwerkfehler nie zwei Rechnungen erzeugen kann. Standardmäßig bis zu 3 Versuche (maxAttempts).
  • Signiert jede Rechnungsanfrage mit HMAC-SHA256 und Ihrem API-Secret. Das Secret selbst wird nie gesendet.
  • verifyWebhook prüft den Header ArionPay-Signature auf dem Raw Body und wirft ArionPaySignatureError, wenn die Signatur nicht passt oder älter als 5 Minuten ist.
  • simulatePayment führt eine Testrechnung durch Szenarien wie exact, underpaid_1pct, overpaid oder late, und sendTestWebhook sendet ein signiertes Beispiel-Event.
  • Fehler sind vom Typ ArionPayError, mit HTTP-Status und einem Code wie rate_limited oder unknown_asset. Meldungen enthalten nie Ihr Secret.

Voraussetzungen und Lizenz

Funktioniert mit
Node.js 18 oder neuer · Express, Next.js (App Router) · ESM, CommonJS und TypeScript-Typen
Kosten
Die Bibliothek ist kostenlos. ArionPay berechnet 0,5 % pro Zahlung, ohne Monatsgebühr.
Quellcode
Open Source (MIT) auf GitHub.

Einrichtung

In 5 Schritten eingerichtet

  1. Schritt 1

    Paket installieren

    Führen Sie npm install arionpay aus. Die Bibliothek hat keine Abhängigkeiten.

  2. Schritt 2

    Schlüssel kopieren

    Öffnen Sie in Ihrem ArionPay-Dashboard Ihren Shop und kopieren Sie den API-Schlüssel (pk_) und das API-Secret (sk_; dafür wird Ihr Authenticator-Code abgefragt). Das Webhook-Signing-Secret (whsec_) finden Sie auf der Seite „Webhooks“. Bewahren Sie alle drei auf Ihrem Server auf, nie im Browser-Code.

  3. Schritt 3

    Rechnung erstellen

    Rufen Sie createInvoice mit Betrag, Währung und Ihrer orderId auf und leiten Sie den Kunden dann zu invoice.invoiceUrl weiter.

  4. Schritt 4

    Webhook prüfen

    Legen Sie Ihre Webhook-Adresse auf der Seite „Webhooks“ fest oder pro Rechnung mit callbackUrl. Lesen Sie den Body mit express.raw, übergeben Sie ihn an verifyWebhook und liefern Sie die Bestellung bei invoice.paid aus.

  5. Schritt 5

    Ohne echtes Geld testen

    Erstellen Sie eine Rechnung mit test: true und einem Asset wie USDT_TRC20 und rufen Sie dann simulatePayment(invoice.id, "exact") auf. Ihr Webhook erhält invoice.paid wie bei einer echten Zahlung.

Nach der Einrichtung

So erreicht eine Zahlung Ihren Code

  • invoice.pending: Eine Zahlung wurde im Netzwerk erkannt und wartet auf Bestätigungen. Zeigen Sie „Zahlung unterwegs“ an, liefern Sie aber noch nicht.
  • invoice.paid: vollständig bezahlt und bestätigt oder von Ihnen manuell im Dashboard akzeptiert. Liefern Sie die Bestellung nur bei diesem Event aus (oder wenn getInvoice „paid“ meldet). Ein Kunde, der zur successUrl zurückkehrt, beweist nichts.
  • Gleichen Sie vor der Lieferung die Rechnung mit Ihrer Bestellung ab: Ihre orderId oder metadata sowie derselbe Betrag und dieselbe Währung wie die aktuelle Gesamtsumme der Bestellung.
  • invoice.partial, invoice.expired und invoice.needs_review bedeuten nie, dass Sie liefern sollen. Eine verspätete Zahlung kann eine abgelaufene Rechnung trotzdem noch auf bezahlt setzen.
  • ArionPay sendet einen Webhook etwa 3 Tage lang erneut, bis Ihr Server mit 2xx antwortet, daher kann dasselbe Event zweimal ankommen. Verarbeiten Sie anhand von event.id jedes Event nur einmal.

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 zur ArionPay-Bibliothek für Node.js

Kurze Antworten, bevor Sie sie in Ihren Code einbauen.

Ja. Lesen Sie in einer App-Router-Route den Body mit await request.text() und übergeben Sie ihn zusammen mit dem Header arionpay-signature und Ihrem Webhook-Secret an verifyWebhook.

Entwickler-Bibliotheken