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 arionpayFonctionnalités
ArionPay pour les développeurs Node.js
En savoir plus
Il 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
Étape 1
Installer le package
Lancez npm install arionpay. Il n’a aucune dépendance.
É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.
Étape 3
Créer une facture
Appelez createInvoice avec le montant, la devise et votre orderId, 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 callbackUrl. Lisez le corps avec express.raw, passez-le à verifyWebhook, 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 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.