Laravel-Paket
Kryptozahlungen in Ihrer Laravel-App annehmen
Erstellen Sie eine Rechnung mit ArionPay::createInvoice und liefern Sie die Bestellung in einem InvoicePaid-Listener aus. Das Paket prüft für Sie die Signatur, den Test- oder Live-Modus und doppelte Zustellungen.
Installieren
composer require arionpay/arionpay-laravelWas es leistet
ArionPay für Laravel-Entwickler
Weiterlesen
Im Testmodus ist jede neue Rechnung eine Testrechnung, sodass Sie den gesamten Ablauf ohne echtes Geld ausprobieren können. Zahlungen gehen direkt an Ihre eigene Wallet: ArionPay verwahrt sie nie.- ArionPay::createInvoice([...]) liefert Ihnen die Adresse der Zahlungsseite (invoiceUrl).
- Zahlungsupdates kommen als Laravel-Events an: InvoicePaid, InvoicePending, InvoicePartial, InvoiceExpired, InvoiceNeedsReview und TestWebhookReceived.
- Die Route POST /arionpay/webhook prüft die ArionPay-Signature über den exakten Body (Zeitfenster von 5 Minuten). Alles andere erhält 401, und es wird kein Event ausgelöst.
- Jedes Event wird genau einmal ausgelöst: Es wird 96 Stunden lang in Ihrem Cache vorgehalten.
- Mit ARIONPAY_TEST_MODE=true werden neue Rechnungen zu Testrechnungen, und es werden nur Test-Webhooks angenommen. Bei einer Abweichung gibt es 409.
- php artisan arionpay:check prüft Ihre Schlüssel und zeigt die Webhook-Adresse. php artisan arionpay:test-webhook fordert bei ArionPay ein signiertes Beispiel-Event an.
- Jedes Event hat matches($amount, $currency), invoiceId(), orderId() und metadata(), um es der Bestellung zuzuordnen.
Voraussetzungen und Lizenz
- Funktioniert mit
- Laravel 10 bis 13 · PHP 8.1 oder neuer · basiert auf arionpay/arionpay-php
- Getestet
- Laravel 13.42 und 12, gegen einen echten ArionPay-Server
- 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 installieren
Führen Sie composer require arionpay/arionpay-laravel aus. Laravel erkennt den Service Provider und die ArionPay-Facade automatisch.
Schritt 2
Schlüssel in .env eintragen
Setzen Sie ARIONPAY_API_KEY (pk_), ARIONPAY_API_SECRET (sk_) und ARIONPAY_WEBHOOK_SECRET (whsec_) aus Ihrem ArionPay-Dashboard sowie ARIONPAY_TEST_MODE=true. Führen Sie dann php artisan arionpay:check aus.
Schritt 3
Rechnung erstellen
Rufen Sie ArionPay::createInvoice mit Betrag, orderId und einem idempotencyKey wie 'order-' . $order->id auf und leiten Sie zu $invoice['invoiceUrl'] weiter. Die Rechnung sendet ihre Updates an die Webhook-Route Ihrer App, sofern Sie keine eigene callbackUrl übergeben.
Schritt 4
Bei InvoicePaid ausliefern
Hören Sie auf ArionPay\Laravel\Events\InvoicePaid, suchen Sie die Bestellung, prüfen Sie $event->matches($order->total, $order->currency) und liefern Sie dann aus. Wirft ein Listener eine Exception, antwortet die Route mit 500, und ArionPay stellt später erneut zu.
Schritt 5
Erst testen, dann live gehen
Erstellen Sie im Testmodus eine Rechnung mit 'asset' => 'USDT_TRC20' und rufen Sie ArionPay::simulatePayment($invoice['id'], 'exact') auf, oder nutzen Sie die Buttons „Try a test payment“ im Dashboard. Setzen Sie ARIONPAY_TEST_MODE=false für echte Zahlungen.
Nach der Einrichtung
So erreicht eine Zahlung Ihren Code
- InvoicePaid: vollständig bezahlt und bestätigt, also ausliefern. Wird auch bei verspäteten Zahlungen, kleinen Abweichungen innerhalb Ihrer Zahlungstoleranz (Standard 1 %) und bei Zahlungen ausgelöst, die Sie in Payment Radar akzeptieren.
- InvoicePending: Die Zahlung wurde im Netzwerk erkannt und wartet auf Bestätigungen. Noch nicht ausliefern.
- InvoicePartial und InvoiceExpired: nicht vollständig bezahlt. Eine verspätete Zahlung kann noch als InvoicePaid folgen.
- InvoiceNeedsReview: Entscheiden Sie in Ihrem ArionPay-Dashboard. Wenn Sie akzeptieren, folgt InvoicePaid.
- TestWebhookReceived: ein Beispiel aus „Send test webhook“ zu einer erfundenen Rechnung. Dafür nie ausliefern.
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 Laravel
Kurze Antworten, bevor Sie sie in Ihren Code einbauen.