Aller au contenu
ArionPay

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

Fonctionnalités

ArionPay pour les développeurs Ruby

La gem arionpay est le client ArionPay officiel pour Ruby 3.0 ou plus récent, et n’utilise que la bibliothèque standard. Elle 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 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

  1. Étape 1

    Installer la gem

    Lancez gem install arionpay, ou ajoutez gem "arionpay" à votre Gemfile.

  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 les credentials Rails.

  3. Étape 3

    Créer une facture

    Appelez create_invoice avec amount:, currency: et order_id:, puis redirigez 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 (request.raw_post dans Rails) et l’en-tête ArionPay-Signature à verify_webhook, et livrez 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, 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.

Oui. Dans un contrôleur basé sur ActionController::API, ou avec skip_forgery_protection, passez request.raw_post et request.headers["ArionPay-Signature"] à verify_webhook. Interceptez ArionPay::SignatureError et répondez 401.

Bibliothèques pour développeurs