Zum Inhalt springen
ArionPay

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

Was es leistet

ArionPay für Laravel-Entwickler

arionpay/arionpay-laravel baut auf der offiziellen PHP-Bibliothek auf, für Laravel 10 bis 13 mit PHP 8.1 oder neuer. Das Paket fügt eine Webhook-Route hinzu, die jedes signierte Update prüft und es genau einmal als normales Laravel-Event auslöst.
WeiterlesenIm 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

  1. Schritt 1

    Paket installieren

    Führen Sie composer require arionpay/arionpay-laravel aus. Laravel erkennt den Service Provider und die ArionPay-Facade automatisch.

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

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

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

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

Laravel 10 bis 13 mit PHP 8.1 oder neuer. Getestet wurde es mit Laravel 13.42 und 12 gegen einen echten ArionPay-Server.

Entwickler-Bibliotheken