Aller au contenu
ArionPay

Bibliothèque PHP

Acceptez les paiements crypto dans votre appli PHP

Créez une facture crypto depuis n’importe quel site PHP, envoyez le client vers la page de paiement, et vérifiez le webhook signé quand il paie. L’argent arrive directement sur votre propre portefeuille.

Installer

composer require arionpay/arionpay-php
Code source sur GitHub
Exemple

Fonctionnalités

ArionPay pour les développeurs PHP

arionpay/arionpay-php est le client ArionPay officiel pour PHP 7.4 et plus récent. Il n’a aucune dépendance : il utilise cURL s’il est installé, et les streams PHP sinon.
En savoir plusVous pouvez l’installer avec Composer, ou téléverser le dossier et faire un require de son autoload.php : il convient donc aussi aux hébergements mutualisés. ArionPay ne détient jamais l’argent : chaque paiement arrive directement sur votre propre portefeuille.
  • PHP 7.4 ou plus récent. Aucune dépendance.
  • Utilise cURL s’il est installé, les streams PHP sinon. Les redirections ne sont jamais suivies.
  • Fonctionne avec ou sans Composer : copiez le dossier et faites un require d’autoload.php.
  • Le même idempotencyKey renvoie toujours la même facture : un rechargement de page ne crée donc pas de deuxième facture. Sans clé de votre part, une clé aléatoire protège les nouvelles tentatives.
  • Signe chaque requête de facture avec HMAC-SHA256 et votre secret API. Le secret lui-même n’est jamais envoyé.
  • Webhook::fromGlobals lit le corps brut et l’en-tête ArionPay-Signature, et lève une SignatureException si la signature est incorrecte ou date de plus de 5 minutes.
  • simulatePayment et sendTestWebhook vous permettent d’essayer tout le parcours sans argent réel.

Prérequis et licence

Compatible avec
PHP 7.4 ou plus récent · avec ou sans Composer, hébergement mutualisé compris · cURL ou streams PHP
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 la bibliothèque

    Lancez composer require arionpay/arionpay-php. Sans Composer, téléversez le dossier à côté de votre site et faites require __DIR__ . '/arionpay-php/autoload.php'.

  2. Étape 2

    Copier vos clés

    Dans votre tableau de bord ArionPay, ouvrez votre boutique et copiez la clé API (pk_) et le secret API (sk_ ; votre code d’authentification vous sera demandé). Le secret de signature des webhooks (whsec_) se trouve sur la page Webhooks. Gardez-les dans des variables d’environnement ou dans un fichier de configuration situé hors de la racine web.

  3. Étape 3

    Créer une facture

    Appelez createInvoice avec le montant, la devise, l’orderId et un idempotencyKey, puis redirigez le client vers $invoice['invoiceUrl'].

  4. Étape 4

    Vérifier le webhook

    Indiquez une adresse publique https:// sur le port 443 ou 8443 dans la page Webhooks, ou par facture avec callbackUrl. Dans ce script, appelez Webhook::fromGlobals($secret) et livrez la commande sur invoice.paid.

  5. Étape 5

    Tester sans argent réel

    Créez une facture avec 'test' => true et un asset comme USDT_TRC20, puis appelez simulatePayment($invoice['id'], 'exact'). Votre webhook reçoit invoice.paid, comme pour un vrai paiement.

Après la configuration

Comment un paiement arrive jusqu’à votre code

  • invoice.pending : un paiement a été détecté sur le réseau et attend des confirmations. Ne livrez pas encore.
  • invoice.paid: fully paid and confirmed, or accepted by you by hand in the dashboard. Deliver only on this event (or when getInvoice() says paid). Coming back to successUrl does not prove payment.
  • Avant de livrer, rapprochez la facture de votre commande : votre orderId ou vos metadata, ainsi que le même montant et la même devise que le total actuel de la commande.
  • invoice.partial, invoice.expired et invoice.needs_review ne signifient jamais qu’il faut livrer. Un paiement en retard peut encore faire passer une facture expirée à payée.
  • ArionPay renvoie la requête pendant environ 3 jours tant que votre serveur ne répond pas 2xx. Ne traitez chaque identifiant d’événement qu’une fois.

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 PHP

Des réponses courtes avant de l’ajouter à votre code.

Oui. Téléversez le dossier arionpay-php à côté de votre site et faites un require de son autoload.php. Cela fonctionne aussi sur un hébergement mutualisé.

Bibliothèques pour développeurs