Aller au contenu
ArionPay

Module Go

Acceptez les paiements crypto dans votre appli Go

Créez des factures crypto depuis votre service Go et vérifiez les webhooks signés avec la seule bibliothèque standard. L’argent arrive directement sur votre propre portefeuille.

Installer

go get github.com/ArionPay-Dev/arionpay-go
Code source sur GitHub
Exemple

Fonctionnalités

ArionPay pour les développeurs Go

arionpay-go est le client ArionPay officiel pour Go 1.21 ou plus récent, sans aucune dépendance hors de la bibliothèque standard. Il crée et lit des factures, vérifie les signatures des webhooks sur le corps brut, et prend un context.Context à chaque appel.
En savoir plusUne facture reçue par webhook et un résultat de GetInvoice sont du même type arionpay.Invoice : une seule fonction peut donc gérer les deux. ArionPay ne détient jamais l’argent : il arrive directement sur votre propre portefeuille.
  • Aucune dépendance (bibliothèque standard uniquement). Go 1.21 ou plus récent.
  • Chaque appel prend un context.Context. Un contexte annulé interrompt aussi les attentes entre deux tentatives.
  • 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 renvoie une *SignatureError si elle ne correspond pas ou date de plus de 5 minutes.
  • Les montants sont des arionpay.Amount : le texte exactement tel qu’ArionPay l’a envoyé, jamais arrondi. inv.Matches("49.90", "USD") compare le total de la commande au centime près.
  • Un Client peut être partagé sans risque entre goroutines. Le client HTTP par défaut a un délai d’expiration de 20 s et ne suit aucune redirection.
  • SimulatePayment et SendTestWebhook vous permettent de tester sans argent réel.

Prérequis et licence

Compatible avec
Go 1.21 ou plus récent · net/http, Gin, Echo, Chi, Fiber · 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

    Ajouter le module

    Lancez go get github.com/ArionPay-Dev/arionpay-go et importez-le sous la forme arionpay "github.com/ArionPay-Dev/arionpay-go".

  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. Passez-les à arionpay.New dans une Config.

  3. Étape 3

    Créer une facture

    Appelez client.CreateInvoice(ctx, arionpay.InvoiceParams{...}) avec Amount, Currency et OrderID, puis redirigez vers inv.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 brut, passez-le à client.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 Test: arionpay.Bool(true) et un Asset comme USDT_TRC20, puis appelez client.SimulatePayment(ctx, 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 GetInvoice renvoie Status "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 Go

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

Oui. Lisez le corps brut avec c.GetRawData() dans Gin ou io.ReadAll(c.Request().Body) dans Echo, et passez-le à VerifyWebhook. Ne liez pas d’abord le corps à une struct.

Bibliothèques pour développeurs