Bibliothèque Python
Acceptez les paiements crypto dans votre appli Python
Créez des factures crypto depuis Flask, Django, FastAPI ou un simple script, et vérifiez le webhook signé quand le client paie. L’argent arrive directement sur votre propre portefeuille.
Installer
pip install arionpayFonctionnalités
ArionPay pour les développeurs Python
En savoir plus
Les factures sont renvoyées sous forme de dicts avec les mêmes noms de champs que le webhook : une seule fonction peut donc traiter un webhook comme une lecture. ArionPay ne détient jamais l’argent : il arrive directement sur votre propre portefeuille.- Aucune dépendance (bibliothèque standard uniquement). Python 3.8 ou plus récent.
- Exemples dans le README pour Flask, Django et FastAPI. Les simples scripts fonctionnent aussi.
- Chaque requête de facture porte une clé d’idempotence : une erreur réseau ne peut donc jamais créer deux factures.
- Signe chaque requête de facture avec HMAC-SHA256 et votre secret API. Le secret lui-même n’est jamais envoyé.
- verify_webhook vérifie l’en-tête ArionPay-Signature sur le corps brut et lève SignatureError si la signature ne correspond pas ou date de plus de 5 minutes.
- simulate_payment fait passer une facture test par des scénarios comme exact, partial_half, overpaid ou late. send_test_webhook envoie un événement d’exemple signé.
- Livré avec des annotations de type (py.typed).
Prérequis et licence
- Compatible avec
- Python 3.8 ou plus récent · Flask, Django, FastAPI ou simples scripts · bibliothèque standard uniquement
- 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 pip install arionpay. Il n’utilise que la bibliothèque standard.
É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 sur votre serveur, par exemple dans des variables d’environnement.
Étape 3
Créer une facture
Appelez create_invoice avec le montant, la devise et votre order_id, puis envoyez le client vers invoice["invoiceUrl"].
Étape 4
Vérifier le webhook
Définissez l’adresse de votre webhook sur la page Webhooks, ou par facture avec callback_url. Passez le corps brut et l’en-tête ArionPay-Signature à verify_webhook, 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 simulate_payment(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 : entièrement payée et confirmée, ou acceptée manuellement par vous dans le tableau de bord. Ne livrez que sur cet événement (ou quand get_invoice indique paid). Revenir sur success_url ne prouve pas le paiement.
- Avant de livrer, rapprochez la facture de votre commande : votre order_id 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 event["id"] 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 Python
Des réponses courtes avant de l’ajouter à votre code.