Aller au contenu
ArionPay

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-laravel
Code source sur GitHub
Exemple

Fonctionnalités

ArionPay pour les développeurs Laravel

arionpay/arionpay-laravel s’appuie sur la bibliothèque PHP officielle, pour Laravel 10 à 13 sous PHP 8.1 ou plus récent. Il ajoute une route de webhook qui vérifie chaque mise à jour signée et la déclenche une seule fois comme un événement Laravel normal.
En savoir plusEn 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

  1. Étape 1

    Installer le package

    Lancez composer require arionpay/arionpay-laravel. Laravel détecte tout seul le service provider et la façade ArionPay.

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

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

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

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

Laravel 10 à 13 avec PHP 8.1 ou plus récent. Le package a été testé sur Laravel 13.42 et 12 face à un vrai serveur ArionPay.

Bibliothèques pour développeurs