Aller au contenu
ArionPay

Bibliothèque Java

Acceptez les paiements crypto dans votre appli Java

Créez des factures crypto depuis votre service Java ou Kotlin et vérifiez les webhooks signés, avec le seul JDK. L’argent arrive directement sur votre propre portefeuille.

Installer

implementation("com.arionpay:arionpay-java:1.0.0")
Code source sur GitHub
Exemple

Fonctionnalités

ArionPay pour les développeurs Java

arionpay-java est le client ArionPay officiel pour Java 11 ou plus récent. Il n’a besoin que du JDK (java.net.http), conserve les prix en monnaie fiat en BigDecimal et les montants crypto sous forme de texte, et vérifie les signatures des webhooks sur le corps brut.
En savoir plusUne facture reçue par webhook et un résultat de getInvoice sont de la même classe Invoice : une seule méthode peut donc gérer les deux. ArionPay ne détient jamais l’argent : il arrive directement sur votre propre portefeuille.
  • Aucune dépendance : uniquement le JDK (java.net.http). Java 11 ou plus récent.
  • Montants exacts : les prix en monnaie fiat sont des BigDecimal, les montants crypto sont conservés sous forme de texte, jamais en double arrondi.
  • Chaque requête de facture porte une clé d’idempotence : une erreur réseau ne peut donc jamais créer deux factures.
  • verifyWebhook vérifie la signature sur le corps brut et lève une SignatureException si elle ne correspond pas ou date de plus de 5 minutes.
  • inv.matches(order total, currency) compare le total de la commande au centime près avant que vous ne livriez.
  • Le client peut être partagé sans risque entre threads : construisez-le une seule fois, par exemple comme bean Spring.
  • Chaque fichier sur Maven Central est signé avec la clé de publication d’ArionPay.

Prérequis et licence

Compatible avec
Java 11 ou plus récent · Spring Boot, Jakarta Servlet, Micronaut, Quarkus, Javalin, Java pur, Kotlin · JDK 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

    Ajouter la dépendance

    Avec Gradle : implementation("com.arionpay:arionpay-java:1.0.0"). Avec Maven : groupId com.arionpay, artifactId arionpay-java, version 1.0.0.

  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_, qui demande votre code d’authentification). Le secret de signature des webhooks (whsec_) se trouve sur la page Webhooks. Passez-les à ArionPay.builder().

  3. Étape 3

    Créer une facture

    Appelez createInvoice(new InvoiceParams("49.90").currency("USD").orderId("1001")), puis envoyez le client vers invoice.getInvoiceUrl().

  4. Étape 4

    Vérifier le webhook

    Définissez l’adresse de votre webhook sur la page Webhooks, ou par facture avec callbackUrl(...). Récupérez le corps en byte[], passez-le à verifyWebhook avec l’en-tête ArionPay-Signature, et livrez sur invoice.paid.

  5. Étape 5

    Tester sans argent réel

    Créez une facture avec .asset("USDT_TRC20").test(true), puis appelez simulatePayment(inv.getId(), "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: fully paid and confirmed, or accepted by you by hand in the dashboard. Deliver only on this event (or when getInvoice(id).isPaid()). Coming back to the success URL does not prove payment.
  • Avant de livrer, rapprochez la facture de votre commande : votre id de commande ou vos metadata, et inv.matches(order.getTotal(), order.getCurrency()).
  • 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 mise à jour pendant environ 3 jours quand votre serveur ne répond pas en 2xx. Traitez chaque event.getId() une seule 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 Java

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

Oui. Récupérez le corps du webhook en @RequestBody byte[] et passez-le à verifyWebhook avec l’en-tête ArionPay-Signature. Si vous utilisez Spring Security, excluez ce chemin de la protection CSRF.

Bibliothèques pour développeurs