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 arionpayWas es leistet
ArionPay für Ruby-Entwickler
Weiterlesen
Rechnungen 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
Schritt 1
Gem installieren
Führen Sie gem install arionpay aus oder fügen Sie gem "arionpay" zu Ihrem Gemfile hinzu.
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.
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.
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.
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.