Package Laravel
Acceptez les paiements crypto dans votre appli Laravel
Créez une facture avec ArionPay::createInvoice et livrez la commande dans un listener InvoicePaid. Le package vérifie pour vous la signature, le mode test ou réel et les livraisons en double.
Installer
composer require arionpay/arionpay-laravelFonctionnalités
ArionPay pour les développeurs Laravel
En savoir plus
En mode test, chaque nouvelle facture est une facture test : vous pouvez donc essayer tout le parcours sans argent réel. Les paiements arrivent directement sur votre propre portefeuille : ArionPay ne les détient jamais.- ArionPay::createInvoice([...]) vous donne l’adresse de la page de paiement (invoiceUrl).
- Les mises à jour de paiement arrivent sous forme d’événements Laravel : InvoicePaid, InvoicePending, InvoicePartial, InvoiceExpired, InvoiceNeedsReview et TestWebhookReceived.
- La route POST /arionpay/webhook vérifie l’ArionPay-Signature sur le corps exact (fenêtre de 5 minutes). Tout le reste reçoit une 401 et aucun événement n’est déclenché.
- Chaque événement n’est déclenché qu’une fois : il est mémorisé dans votre cache pendant 96 heures.
- ARIONPAY_TEST_MODE=true fait des nouvelles factures des factures test et n’accepte que les webhooks de test. En cas de désaccord, la réponse est 409.
- php artisan arionpay:check vérifie vos clés et affiche l’adresse du webhook. php artisan arionpay:test-webhook demande à ArionPay un événement d’exemple signé.
- Chaque événement dispose de matches($amount, $currency), invoiceId(), orderId() et metadata() pour retrouver la commande.
Prérequis et licence
- Compatible avec
- Laravel 10 à 13 · PHP 8.1 ou plus récent · basé sur arionpay/arionpay-php
- Testé
- Laravel 13.42 et 12, face à un vrai serveur ArionPay
- Coût
- La bibliothèque est gratuite. ArionPay prélève 0,5 % par paiement, sans frais mensuels.
- Code source
- Open source (MIT) sur GitHub.
Installation
Mise en place en 5 étapes
Étape 1
Installer le package
Lancez composer require arionpay/arionpay-laravel. Laravel détecte tout seul le service provider et la façade ArionPay.
Étape 2
Ajouter vos clés dans .env
Définissez ARIONPAY_API_KEY (pk_), ARIONPAY_API_SECRET (sk_) et ARIONPAY_WEBHOOK_SECRET (whsec_) depuis votre tableau de bord ArionPay, ainsi que ARIONPAY_TEST_MODE=true. Lancez ensuite php artisan arionpay:check.
Étape 3
Créer une facture
Appelez ArionPay::createInvoice avec le montant, l’orderId et un idempotencyKey comme 'order-' . $order->id, puis redirigez vers $invoice['invoiceUrl']. La facture envoie ses mises à jour à la route de webhook de votre appli, sauf si vous passez votre propre callbackUrl.
Étape 4
Livrer sur InvoicePaid
Écoutez ArionPay\Laravel\Events\InvoicePaid, retrouvez la commande, vérifiez $event->matches($order->total, $order->currency), puis livrez. Si un listener lève une exception, la route répond 500 et ArionPay renvoie la mise à jour plus tard.
Étape 5
Tester, puis passer en production
En mode test, créez une facture avec 'asset' => 'USDT_TRC20' et appelez ArionPay::simulatePayment($invoice['id'], 'exact'), ou utilisez les boutons « Try a test payment » du tableau de bord. Réglez ARIONPAY_TEST_MODE=false pour les vrais paiements.
Après la configuration
Comment un paiement arrive jusqu’à votre code
- InvoicePaid : entièrement payée et confirmée, donc livrez. Il est aussi déclenché pour les paiements en retard, les petits écarts compris dans votre tolérance de paiement (1 % par défaut) et les paiements que vous acceptez dans Payment Radar.
- InvoicePending : le paiement a été détecté sur le réseau et attend des confirmations. Ne livrez pas encore.
- InvoicePartial et InvoiceExpired : pas entièrement payée. Un paiement en retard peut encore suivre sous forme d’InvoicePaid.
- InvoiceNeedsReview : décidez dans votre tableau de bord ArionPay. Si vous acceptez, InvoicePaid suit.
- TestWebhookReceived : un exemple envoyé par « Send test webhook », concernant une facture fictive. Ne livrez jamais pour cet événement.
16 cryptos et jetons sur 9 réseaux
Toutes les cryptos- BTCBitcoin
- ETHEthereum
- USDTEthereum
- USDCEthereum
- BNBBNB Smart Chain
- USDTBNB Smart Chain
- USDCBNB Smart Chain
- POLPolygon
- USDTPolygon
- USDCPolygon
- TRXTRON
- USDTTRON
- LTCLitecoin
- DOGEDogecoin
- BCHBitcoin Cash
- DASHDash
Questions sur la bibliothèque ArionPay pour Laravel
Des réponses courtes avant de l’ajouter à votre code.