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-phpFonctionnalités
ArionPay pour les développeurs PHP
En savoir plus
Vous 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
É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'.
É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.
É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'].
É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.
É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.