Gem Ruby
Acceptez les paiements crypto dans votre appli Ruby
Créez des factures crypto depuis votre appli Rails, Sinatra ou Rack et vérifiez le webhook signé quand le client paie. L’argent arrive directement sur votre propre portefeuille.
Installer
gem install arionpayFonctionnalités
ArionPay pour les développeurs Ruby
En savoir plus
Les factures sont des Hashes avec les mêmes noms de champs que le webhook : une seule méthode 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). Ruby 3.0 ou plus récent.
- Exemples dans le README pour Rails, Sinatra et Rack seul. Hanami et 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.
- verify_webhook vérifie la signature sur le corps brut et lève ArionPay::SignatureError si elle ne correspond pas ou date de plus de 5 minutes.
- ArionPay.order_matches?(invoice, "49.90", "USD") vérifie le total de la commande au centime près avant que vous ne livriez.
- Un client peut être partagé sans risque entre threads (Puma, Sidekiq).
- Des arguments incorrects lèvent ArgumentError avant tout envoi. Les erreurs d’API sont des ArionPay::APIError, et les messages ne contiennent jamais votre secret.
Prérequis et licence
- Compatible avec
- Ruby 3.0 ou plus récent · Rails, Sinatra, Hanami, toute appli Rack 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 la gem
Lancez gem install arionpay, ou ajoutez gem "arionpay" à votre Gemfile.
É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 les credentials Rails.
Étape 3
Créer une facture
Appelez create_invoice avec amount:, currency: et order_id:, puis redirigez 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 (request.raw_post dans Rails) et l’en-tête ArionPay-Signature à verify_webhook, et livrez 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, et ArionPay.order_matches? pour le montant et la devise.
- 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 et répondez vite, en envoyant les e-mails depuis une tâche en arrière-plan.
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 Ruby
Des réponses courtes avant de l’ajouter à votre code.