Aller au contenu
ArionPay

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

Fonctionnalités

ArionPay pour les développeurs Python

arionpay est le client ArionPay officiel pour Python 3.8 ou plus récent, écrit uniquement avec la bibliothèque standard. Il crée et lit des factures, vérifie les signatures des webhooks sur le corps brut, et fait passer des factures test par des scénarios de paiement.
En savoir plusLes 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

  1. Étape 1

    Installer le package

    Lancez pip install arionpay. Il n’utilise que la bibliothèque standard.

  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 sur votre serveur, par exemple dans des variables d’environnement.

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

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

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

Oui. Marquez la vue avec @csrf_exempt et @require_POST, puis passez request.body et l’en-tête ArionPay-Signature à verify_webhook.

Bibliothèques pour développeurs