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 arionpayWas es leistet
ArionPay für Node.js-Entwickler
Weiterlesen
Er 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
Schritt 1
Paket installieren
Führen Sie npm install arionpay aus. Die Bibliothek hat keine Abhängigkeiten.
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.
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.
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.
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.