Zum Inhalt springen
ArionPay

Ruby-Gem

Kryptozahlungen in Ihrer Ruby-App annehmen

Erstellen Sie Krypto-Rechnungen aus Ihrer Rails-, Sinatra- oder Rack-App und prüfen Sie den signierten Webhook, wenn der Kunde zahlt. Das Geld geht direkt an Ihre eigene Wallet.

Installieren

gem install arionpay
Quellcode auf GitHub
Beispiel

Was es leistet

ArionPay für Ruby-Entwickler

Das Gem arionpay ist der offizielle ArionPay-Client für Ruby 3.0 oder neuer und nutzt nur die Standardbibliothek. Es erstellt und liest Rechnungen, prüft Webhook-Signaturen auf dem Raw Body und führt Testrechnungen durch Zahlungsszenarien.
WeiterlesenRechnungen sind Hashes mit denselben Feldnamen wie im Webhook, sodass eine Methode einen Webhook und eine Abfrage verarbeiten kann. ArionPay verwahrt das Geld nie: Es geht direkt an Ihre eigene Wallet.
  • Keine Abhängigkeiten (nur Standardbibliothek). Ruby 3.0 oder neuer.
  • README-Beispiele für Rails, Sinatra und reines Rack. Hanami und einfache Skripte funktionieren auch.
  • Jede Rechnungsanfrage enthält einen Idempotency-Key, sodass ein Netzwerkfehler nie zwei Rechnungen erzeugen kann.
  • verify_webhook prüft die Signatur auf dem Raw Body und löst ArionPay::SignatureError aus, wenn sie nicht passt oder älter als 5 Minuten ist.
  • ArionPay.order_matches?(invoice, "49.90", "USD") prüft vor der Lieferung die Bestellsumme auf den Cent genau.
  • Ein Client kann sicher zwischen Threads geteilt werden (Puma, Sidekiq).
  • Ungültige Argumente lösen ArgumentError aus, bevor etwas gesendet wird. API-Fehler sind vom Typ ArionPay::APIError, und Meldungen enthalten nie Ihr Secret.

Voraussetzungen und Lizenz

Funktioniert mit
Ruby 3.0 oder neuer · Rails, Sinatra, Hanami, jede Rack-App oder einfache Skripte · 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

    Gem installieren

    Führen Sie gem install arionpay aus oder fügen Sie gem "arionpay" zu Ihrem Gemfile hinzu.

  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 den Rails Credentials auf.

  3. Schritt 3

    Rechnung erstellen

    Rufen Sie create_invoice mit amount:, currency: und order_id: 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 callback_url:. Übergeben Sie den Raw Body (in Rails request.raw_post) und den Header ArionPay-Signature an verify_webhook 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 simulate_payment(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. Noch nicht liefern.
  • invoice.paid: vollständig bezahlt und bestätigt oder von Ihnen manuell im Dashboard akzeptiert. Liefern Sie nur bei diesem Event (oder wenn get_invoice „paid“ meldet). Die Rückkehr zur success_url beweist keine Zahlung.
  • Gleichen Sie vor der Lieferung die Rechnung mit Ihrer Bestellung ab: Ihre order_id oder metadata sowie ArionPay.order_matches? für Betrag und Währung.
  • 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 event["id"] nur einmal und antworten Sie schnell; E-Mails versenden Sie besser aus einem Hintergrundjob.

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 Ruby

Kurze Antworten, bevor Sie sie in Ihren Code einbauen.

Ja. Übergeben Sie in einem Controller auf Basis von ActionController::API oder mit skip_forgery_protection request.raw_post und request.headers["ArionPay-Signature"] an verify_webhook. Fangen Sie ArionPay::SignatureError mit rescue ab und antworten Sie mit 401.

Entwickler-Bibliotheken