Zum Inhalt springen
ArionPay

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

Was es leistet

ArionPay für .NET-Entwickler

ArionPay auf NuGet ist der offizielle ArionPay-Client für .NET 8 oder neuer. Er braucht nichts außer .NET selbst (HttpClient und System.Text.Json), hält Preise als decimal und Krypto-Beträge als Text und prüft Webhook-Signaturen auf dem Raw Body.
WeiterlesenJeder 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

  1. Schritt 1

    Paket hinzufügen

    Führen Sie dotnet add package ArionPay aus. Das Paket hat keine Abhängigkeiten außerhalb von .NET.

  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 sie in Umgebungsvariablen oder in User Secrets auf.

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

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

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

Ja. Übergeben Sie Request.Body und den Header ArionPay-Signature an VerifyWebhookAsync und nehmen Sie die Action von der Antiforgery-Validierung aus: ArionPay ruft sie auf, kein Browserformular.

Entwickler-Bibliotheken