.NET-Bibliothek
Kryptozahlungen in Ihrer .NET-App annehmen
Erstellen Sie Krypto-Rechnungen aus ASP.NET Core und prüfen Sie signierte Webhooks, durchgehend asynchron. Das Geld geht direkt an Ihre eigene Wallet.
Installieren
dotnet add package ArionPayWas es leistet
ArionPay für .NET-Entwickler
Weiterlesen
Jeder Aufruf ist asynchron und nimmt ein CancellationToken entgegen. ArionPay verwahrt das Geld nie: Es geht direkt an Ihre eigene Wallet.- Keine Abhängigkeiten: nur .NET selbst (HttpClient, System.Text.Json). .NET 8 oder neuer (8, 9, 10).
- Durchgehend asynchron, mit einem CancellationToken bei jedem Aufruf.
- Jede Rechnungsanfrage enthält einen Idempotency-Key, sodass ein Netzwerkfehler nie zwei Rechnungen erzeugen kann.
- VerifyWebhookAsync liest den Request-Body, prüft die Signatur und wirft ArionPaySignatureException, wenn sie nicht passt oder älter als 5 Minuten ist.
- Exakte Beträge: Preise sind decimal, Kryptobeträge werden als Text gespeichert. inv.Matches(49.90m, "USD") vergleicht die Bestellsumme auf den Cent genau.
- Threadsicher: Registrieren Sie den Client einmal als Singleton. Sie können Ihren eigenen HttpClient übergeben, zum Beispiel aus IHttpClientFactory.
- Mit SimulatePaymentAsync und SendTestWebhookAsync testen Sie ohne echtes Geld.
Voraussetzungen und Lizenz
- Funktioniert mit
- .NET 8 oder neuer · ASP.NET Core Minimal APIs und Controller, Worker Services, Konsolen-Apps
- 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 hinzufügen
Führen Sie dotnet add package ArionPay aus. Das Paket hat keine Abhängigkeiten außerhalb von .NET.
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 sie in Umgebungsvariablen oder in User Secrets auf.
Schritt 3
Client registrieren und Rechnung erstellen
Registrieren Sie einen ArionPayClient als Singleton. Rufen Sie CreateInvoiceAsync mit einem InvoiceRequest (Amount, Currency, OrderId) auf und leiten Sie 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. Übergeben Sie request.Body und den Header ArionPay-Signature an VerifyWebhookAsync und liefern Sie 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 SimulatePaymentAsync(inv.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. Noch nicht liefern.
- invoice.paid: vollständig bezahlt und bestätigt oder von Ihnen manuell im Dashboard akzeptiert. Liefern Sie nur bei diesem Event aus (oder wenn GetInvoiceAsync „paid“ meldet). Die Rückkehr zur SuccessUrl beweist keine Zahlung.
- Gleichen Sie vor der Lieferung die Rechnung mit Ihrer Bestellung ab: Ihre OrderId oder Metadata sowie inv.Matches(order.Total, order.Currency).
- 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 etwa 3 Tage lang erneut, wenn Ihr Server nicht mit 2xx antwortet. Verarbeiten Sie jede ev.Id 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 .NET
Kurze Antworten, bevor Sie sie in Ihren Code einbauen.