Zum Inhalt springen
ArionPay

Go-Modul

Kryptozahlungen in Ihrer Go-App annehmen

Erstellen Sie Krypto-Rechnungen aus Ihrem Go-Service und prüfen Sie signierte Webhooks, nur mit der Standardbibliothek. Das Geld geht direkt an Ihre eigene Wallet.

Installieren

go get github.com/ArionPay-Dev/arionpay-go
Quellcode auf GitHub
Beispiel

Was es leistet

ArionPay für Go-Entwickler

arionpay-go ist der offizielle ArionPay-Client für Go 1.21 oder neuer, ohne Abhängigkeiten außerhalb der Standardbibliothek. Er erstellt und liest Rechnungen, prüft Webhook-Signaturen auf dem Raw Body und nimmt bei jedem Aufruf einen context.Context entgegen.
WeiterlesenEine Rechnung aus einem Webhook und ein Ergebnis von GetInvoice haben denselben Typ arionpay.Invoice, sodass eine Funktion beides verarbeiten kann. ArionPay verwahrt das Geld nie: Es geht direkt an Ihre eigene Wallet.
  • Keine Abhängigkeiten (nur Standardbibliothek). Go 1.21 oder neuer.
  • Jeder Aufruf nimmt einen context.Context entgegen. Ein abgebrochener Context beendet auch die Wartezeiten zwischen Wiederholungsversuchen.
  • Jede Rechnungsanfrage enthält einen Idempotency-Key, sodass ein Netzwerkfehler nie zwei Rechnungen erzeugen kann.
  • VerifyWebhook prüft die Signatur auf dem Raw Body und gibt einen *SignatureError zurück, wenn sie nicht passt oder älter als 5 Minuten ist.
  • Beträge sind vom Typ arionpay.Amount: der Text genau so, wie ArionPay ihn gesendet hat, nie gerundet. inv.Matches("49.90", "USD") vergleicht die Bestellsumme auf den Cent genau.
  • Ein Client kann sicher zwischen Goroutinen geteilt werden. Der Standard-HTTP-Client hat ein Timeout von 20 s und folgt keinen Weiterleitungen.
  • Mit SimulatePayment und SendTestWebhook testen Sie ohne echtes Geld.

Voraussetzungen und Lizenz

Funktioniert mit
Go 1.21 oder neuer · net/http, Gin, Echo, Chi, Fiber · nur Standardbibliothek
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

    Modul hinzufügen

    Führen Sie go get github.com/ArionPay-Dev/arionpay-go aus und importieren Sie das Modul als arionpay "github.com/ArionPay-Dev/arionpay-go".

  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“. Übergeben Sie sie in einer Config an arionpay.New.

  3. Schritt 3

    Rechnung erstellen

    Rufen Sie client.CreateInvoice(ctx, arionpay.InvoiceParams{...}) mit Amount, Currency und OrderID auf und leiten Sie dann zu inv.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 Raw Body, übergeben Sie ihn mit dem Header ArionPay-Signature an client.VerifyWebhook und liefern Sie bei invoice.paid aus.

  5. Schritt 5

    Ohne echtes Geld testen

    Erstellen Sie eine Rechnung mit Test: arionpay.Bool(true) und einem Asset wie USDT_TRC20 und rufen Sie dann client.SimulatePayment(ctx, 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 GetInvoice den Status "paid" zurückgibt). 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 Go

Kurze Antworten, bevor Sie sie in Ihren Code einbauen.

Ja. Lesen Sie den Raw Body in Gin mit c.GetRawData() oder in Echo mit io.ReadAll(c.Request().Body) und übergeben Sie ihn an VerifyWebhook. Binden Sie den Body nicht vorher an ein Struct.

Entwickler-Bibliotheken