Aller au contenu principal

Introduction

La Merchant API Volet.com permet à votre application d’accepter des paiements crypto, d’envoyer des paiements et des transferts, de suivre les transactions et de consulter les données du compte, comme les soldes, les tarifs et les limites.

Pour des scénarios pas à pas, consultez les guides : Intégration API pour accepter des paiements et Intégration API pour les paiements de masse.

URL de base​

https://api.volet.com

Tous les endpoints sont relatifs à cette URL, par exemple https://api.volet.com/api/account/balances.

Avant de commencer​

  • Un compte Volet.com vérifié, personnel ou Business.
  • Une API créée dans la section des outils de paiement de votre compte, avec les autorisations dont votre intégration a besoin. Voir Créer une passerelle de paiement ou Activer les paiements de masse.
  • Les adresses IP de vos serveurs dans la liste blanche IP de l’API.

Volet.com ne propose pas de sandbox. Testez votre intégration avec de petites transactions réelles.

Authentification​

Chaque requête comporte trois en-têtes :

En-têteValeur
Api-NameLe nom de l’API dans votre compte Volet.com
Account-EmailL’adresse e-mail du compte Volet.com propriétaire de l’API
Authentication-TokenUn jeton SHA-256 généré à partir du mot de passe de l’API et de la date et de l’heure UTC actuelles

Générer le jeton d’authentification​

  1. Construisez la chaîne password:YYYYMMDD:HH, où password est le mot de passe de votre API, la date et l’heure étant en UTC.
  2. Calculez le hash SHA-256 de cette chaîne.
  3. Envoyez le hash sous forme de chaîne hexadécimale dans l’en-tête Authentication-Token. L’API ne tient pas compte de la casse ; on utilise d’ordinaire les minuscules.

Par exemple, pour le mot de passe MySecret123 à 14:00 UTC le 26 octobre 2026 :

SHA256("MySecret123:20261026:14")

donne :

c98e6521afe72b0945d9fdefdf3fd0b4dea10baa7f69325a7d6381c15f2421fd

Le jeton change chaque heure UTC. Générez-le juste avant chaque requête. L’API accepte aussi les jetons de l’heure précédente et de l’heure suivante : une requête envoyée au changement d’heure ou depuis un serveur dont l’horloge est légèrement décalée n’est donc pas refusée.

Dans le panneau Try it de chaque méthode, vous pouvez saisir le mot de passe de l’API et générer le jeton dans votre navigateur. Le mot de passe n’est envoyé nulle part.

Gardez le mot de passe sur votre serveur

Seul le jeton est envoyé à l’API, jamais le mot de passe. Ne mettez pas le mot de passe de l’API ni les jetons dans du code frontend, des applications mobiles, des bots ou d’autres scripts côté client.

Format des requêtes​

  • Les requêtes et les réponses utilisent JSON sur HTTPS. Envoyez Content-Type: application/json avec le corps des requêtes.
  • Les montants sont des nombres décimaux, par exemple "amount": 100. L’API les accepte aussi sous forme de chaînes, comme "amount": "100.00". Le nombre de décimales dépend de la devise.
  • Les codes des stablecoins contiennent le réseau là où les fonds transitent par une blockchain, par exemple USDT_TRC20 ; les devises des portefeuilles n’en ont pas, comme USDT. Voir Codes de devise et montants.

Exemple de requête :

curl https://api.volet.com/api/account/balances \
-H "Api-Name: my-api" \
-H "Account-Email: [email protected]" \
-H "Authentication-Token: c98e6521afe72b0945d9fdefdf3fd0b4dea10baa7f69325a7d6381c15f2421fd"

Limite de requêtes​

Pour les comptes personnels et les comptes professionnels qui n’ont pas terminé la vérification, l’API limite le nombre de requêtes par heure. Lorsque la limite est épuisée, l’API renvoie HTTP 401 avec l’erreur attemptsHaveEndedException. Patientez et envoyez la requête plus tard. Les comptes professionnels vérifiés n’ont pas cette limite horaire.