Aller au contenu
ArionPay

Bibliothèque Node.js / TypeScript

Acceptez les paiements crypto dans votre appli Node.js

Créez une facture crypto depuis votre serveur Node.js, envoyez le client vers la page de paiement ArionPay, et vérifiez le webhook signé quand il paie. L’argent arrive directement sur votre propre portefeuille.

Installer

npm install arionpay
Code source sur GitHub
Exemple

Fonctionnalités

ArionPay pour les développeurs Node.js

arionpay est le client ArionPay officiel pour Node.js. Il crée et lit des factures, et vérifie la signature de chaque webhook sur le corps brut avant que vous ne lui fassiez confiance.
En savoir plusIl n’a aucune dépendance, est livré en versions ESM et CommonJS avec des types TypeScript, et fonctionne sur Node.js 18 ou plus récent. ArionPay ne détient jamais l’argent : chaque paiement arrive directement sur votre propre portefeuille.
  • Aucune dépendance. Node.js 18 ou plus récent.
  • ESM et CommonJS, avec les types TypeScript.
  • Chaque requête de facture porte une clé d’idempotence : une erreur réseau ne peut donc jamais créer deux factures. Jusqu’à 3 tentatives par défaut (maxAttempts).
  • Signe chaque requête de facture avec HMAC-SHA256 et votre secret API. Le secret lui-même n’est jamais envoyé.
  • verifyWebhook vérifie l’en-tête ArionPay-Signature sur le corps brut et lève une ArionPaySignatureError si la signature ne correspond pas ou date de plus de 5 minutes.
  • simulatePayment fait passer une facture test par des scénarios comme exact, underpaid_1pct, overpaid ou late, et sendTestWebhook envoie un événement d’exemple signé.
  • Les erreurs sont des ArionPayError avec un statut HTTP et un code comme rate_limited ou unknown_asset. Les messages ne contiennent jamais votre secret.

Prérequis et licence

Compatible avec
Node.js 18 ou plus récent · Express, Next.js (App Router) · ESM, CommonJS et types TypeScript
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 npm install arionpay. Il n’a aucune dépendance.

  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 trois sur votre serveur, jamais dans du code exécuté par le navigateur.

  3. Étape 3

    Créer une facture

    Appelez createInvoice avec le montant, la devise et votre orderId, 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 callbackUrl. Lisez le corps avec express.raw, passez-le à verifyWebhook, 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 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. Affichez « paiement en route », mais 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 la commande que sur cet événement (ou quand getInvoice indique paid). Un client qui revient sur successUrl ne prouve rien.
  • 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 un webhook pendant environ 3 jours, jusqu’à ce que votre serveur réponde 2xx : le même événement peut donc arriver deux fois. Utilisez event.id pour ne traiter chacun 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 Node.js

Des réponses courtes avant de l’ajouter à votre code.

Oui. Dans une route App Router, lisez le corps avec await request.text() et passez-le à verifyWebhook avec l’en-tête arionpay-signature et votre secret de webhook.

Bibliothèques pour développeurs