Aller au contenu
ArionPay

Bibliothèque .NET

Acceptez les paiements crypto dans votre appli .NET

Créez des factures crypto depuis ASP.NET Core et vérifiez les webhooks signés, en asynchrone de bout en bout. L’argent arrive directement sur votre propre portefeuille.

Installer

dotnet add package ArionPay
Code source sur GitHub
Exemple

Fonctionnalités

ArionPay pour les développeurs .NET

ArionPay sur NuGet est le client ArionPay officiel pour .NET 8 ou plus récent. Il n’a besoin que de .NET lui-même (HttpClient et System.Text.Json), conserve les prix en decimal et les montants crypto sous forme de texte, et vérifie les signatures des webhooks sur le corps brut.
En savoir plusChaque appel est asynchrone et prend un CancellationToken. ArionPay ne détient jamais l’argent : il arrive directement sur votre propre portefeuille.
  • Aucune dépendance : uniquement .NET lui-même (HttpClient, System.Text.Json). .NET 8 ou plus récent (8, 9, 10).
  • Asynchrone de bout en bout, avec un CancellationToken à chaque appel.
  • Chaque requête de facture porte une clé d’idempotence : une erreur réseau ne peut donc jamais créer deux factures.
  • VerifyWebhookAsync lit le corps de la requête, vérifie la signature et lève une ArionPaySignatureException si elle ne correspond pas ou date de plus de 5 minutes.
  • Montants exacts : les prix sont des decimal, les montants crypto sont conservés sous forme de texte. inv.Matches(49.90m, "USD") compare le total de la commande au centime près.
  • Thread-safe : enregistrez le client une seule fois comme singleton. Vous pouvez passer votre propre HttpClient, par exemple issu d’IHttpClientFactory.
  • SimulatePaymentAsync et SendTestWebhookAsync vous permettent de tester sans argent réel.

Prérequis et licence

Compatible avec
.NET 8 ou plus récent · minimal APIs et contrôleurs ASP.NET Core, worker services, applis console
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

    Ajouter le package

    Lancez dotnet add package ArionPay. Il n’a aucune dépendance en dehors de .NET.

  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 user secrets.

  3. Étape 3

    Enregistrer le client et créer une facture

    Enregistrez un seul ArionPayClient comme singleton. Appelez CreateInvoiceAsync avec une InvoiceRequest (Amount, Currency, OrderId), puis redirigez 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. Passez request.Body et l’en-tête ArionPay-Signature à VerifyWebhookAsync, 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 SimulatePaymentAsync(inv.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 GetInvoiceAsync indique paid). Revenir sur SuccessUrl ne prouve pas le paiement.
  • Avant de livrer, rapprochez la facture de votre commande : votre OrderId ou vos Metadata, et inv.Matches(order.Total, order.Currency).
  • 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 ev.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 .NET

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

Oui. Passez Request.Body et l’en-tête ArionPay-Signature à VerifyWebhookAsync, et excluez l’action de la validation antiforgery : c’est ArionPay qui l’appelle, pas un formulaire de navigateur.

Bibliothèques pour développeurs