Moove API
Un appel. Payé intégralement.
Créez un lien de paiement depuis votre code. Votre client paie avec n’importe quel token, et vous recevez le montant intégral dans le vôtre.
De la clé au premier paiement.
Créez une clé API
Dans Moove Business, créez une clé pour le Moove Receive Agent. Elle ne s’affiche qu’une fois : placez-la directement dans votre environnement.Créez un lien de paiement
Un seul POST renvoie une URL de paiement. Votre client y paie, avec n’importe quel token, sur n’importe quelle blockchain.Soyez averti du paiement
Enregistrez un point de terminaison HTTPS : Moove lui envoie un événement signé dès qu’un lien est payé.
Une API compacte. Des garanties solides.
Tout token à l’entrée, le vôtre à la sortie
Vos clients paient avec ce qu’ils détiennent, sur plus de 30 réseaux blockchain. Chaque paiement est réglé sur votre portefeuille, dans le token et sur la blockchain de votre choix.Un contrat sur lequel bâtir
Versionnée dans le chemin, uniquement additive en v1, avec un schéma OpenAPI toujours à jour.Limites claires, erreurs claires
Des limites par clé et par IP, un simple 429 et un format d’erreur unique aux codes stables.L’API elle-même est gratuite.
Ni abonnement ni frais par appel. Un client qui paie dans un autre token ou sur une autre blockchain prend en charge les 0,02 %, et vous recevez le montant intégral.- Accès à l’API
- Gratuit
- Même token, même réseau
- Gratuit
- Entre tokens ou réseaux
- 0,02 %
Moove ou tout construire vous-même.
| Moove ou tout construire vous-même. | Moove | Développement interne |
|---|---|---|
| Blockchains couvertes | Moove: 30+, depuis un seul point de terminaison | Développement interne: Une intégration par blockchain |
| Conversion vers votre token | Moove: Intégrée à chaque paiement | Développement interne: Votre propre routage de swaps et de bridges |
| Savoir qu’un paiement est arrivé | Moove: Webhooks signés et un point de terminaison de liste | Développement interne: Vos propres écouteurs pour chaque blockchain |
| Page de paiement | Moove: Un lien hébergé, prêt à partager | Développement interne: Conçue, développée et hébergée par vous |
| En cas de fuite d’une clé | Moove: Elle ne peut que demander des paiements à votre profit | Développement interne: Tout ce que contient le hot wallet |
Questions fréquentes.
Comment obtenir une clé API ?
Connectez-vous à la console Moove Business et ouvrez Clés API. Nommez la clé et choisissez le Moove Receive Agent, qui autorise la création et la lecture de liens de paiement. La clé complète ne s’affiche qu’une fois, à sa création, puis plus jamais : conservez-la dans un gestionnaire de secrets. Aucun point de terminaison ne crée de clés, donc une clé ne peut jamais en émettre une autre.
Où va l’argent quand un client paie ?
Vers le portefeuille par défaut du propriétaire de la clé, sur la blockchain et dans le token de règlement de ce portefeuille. L’appelant ne peut pas désigner d’autre destination. C’est pourquoi le compte doit avoir un Moove handle réservé et un portefeuille par défaut doté d’un token de règlement avant le premier appel ; s’il manque l’un des deux, la création d’un lien renvoie une erreur 409 indiquant que le compte n’est pas prêt à recevoir des paiements.
Existe-t-il une API de versements ?
Pas encore. L’API reçoit des paiements ; elle n’en envoie pas. Pour payer aujourd’hui vos fournisseurs ou prestataires, utilisez Envoyer dans la console Moove Business. Un Moove Send Agent a été annoncé et apparaîtra dans la documentation dès sa sortie.
Comment fonctionnent les webhooks Moove ?
Enregistrez jusqu’à cinq points de terminaison HTTPS dans la console. Chacun reçoit deux événements : l’un quand un paiement sur un lien est réglé, l’autre quand un lien est complété. Les envois sont signés en HMAC-SHA256 avec un secret affiché une seule fois. La livraison est garantie au moins une fois : dédupliquez donc sur l’id de l’événement. Un envoi échoué est retenté jusqu’à six fois.
Y a-t-il des limites de débit ?
Oui. Les requêtes sont limitées par clé API et par IP source, selon la limite atteinte en premier, et tout dépassement renvoie une erreur 429. Appliquez un backoff exponentiel avec un peu de jitter plutôt que de réessayer immédiatement, car les requêtes rejetées comptent quand même. Utilisez les webhooks pour suivre le statut des paiements au lieu d’interroger un lien en boucle, et tenez compte de la limite par IP si plusieurs intégrations partagent un même hôte.
Comment l’API est-elle versionnée ?
Dans le chemin. Il existe aujourd’hui une version publique, v1. Les changements au sein d’une version ne font qu’ajouter : nouveaux points de terminaison, nouveaux champs facultatifs, nouveaux champs de réponse. Tout ce qui casserait un client, comme supprimer un champ ou changer un type, est publié dans une nouvelle version du chemin. Concevez votre client pour ignorer les champs inconnus et pour se fier aux codes d’erreur, jamais aux messages.
