API d'intégration de paiements pour agents IA : permettre aux agents de développement d'ajouter des paiements crypto
Les agents de développement IA peuvent désormais créer un produit fonctionnel en quelques minutes. Ils créent des écrans, écrivent des routes serveur, ajoutent des bases de données et connectent des intégrations. Les paiements restent à part. La plupart des fournisseurs de paiement supposent encore qu'un humain ouvrira un tableau de bord, créera un compte, configurera des produits, réglera les webhooks puis reportera ces informations dans l'application.
Cette boucle manuelle casse le processus de l'agent. Quand un utilisateur dit « ajoute des paiements », l'agent ne devrait pas l'envoyer effectuer des étapes de configuration. L'agent devrait disposer d'un parcours officiel pour découvrir Yolfi, préparer des liens de paiement, ajouter une page de paiement, configurer les webhooks et vérifier le résultat.
Yolfi Agent Kit est conçu pour ce scénario.
Le problème
Les agents savent créer des applications, mais la configuration des paiements demande encore souvent un travail manuel dans un tableau de bord :
- créer un compte ;
- trouver la bonne documentation développeur ;
- créer des liens de paiement ou des produits ;
- définir des URL de webhook ;
- vérifier les signatures ;
- relier le statut du paiement à la logique d'accès de l'application.
Pour un développeur humain, c'est pénible. Pour un agent de développement IA, c'est un point d'arrêt si le fournisseur ne propose pas un parcours lisible par machine avec des limites de sécurité claires.
L'approche Yolfi
Yolfi Agent Kit donne aux agents de développement la même surface produit que celle utilisée par les développeurs, mais sous une forme qu'un agent peut trouver et suivre :
- un guide pour agents explique le parcours d'intégration sûr ;
- le paquet npm fournit des commandes structurées ;
- le serveur MCP expose les actions Yolfi aux environnements d'agents ;
- l'API Yolfi existante reste la source de vérité pour les liens de paiement, les paramètres d'organisation et le statut des paiements.
L'idée essentielle est simple : l'utilisateur valide les décisions métier, tandis que l'agent réalise l'intégration dans le code du produit.
Processus pour l'agent
Un agent de développement peut :
- examiner l'application cible ;
- vérifier si Yolfi est déjà configuré ;
- préparer un espace de travail Yolfi si nécessaire ;
- demander à l'utilisateur le portefeuille, le produit, le prix, la devise et le type de paiement ;
- configurer les portefeuilles de règlement et l'URL du webhook ;
- créer ou réutiliser un lien de paiement ;
- enregistrer l'identifiant du lien de paiement dans les variables d'environnement ou la configuration de l'application ;
- ajouter une page de paiement ou une route serveur ;
- ajouter la vérification de signature des webhooks ;
- vérifier le statut du paiement via Yolfi.
Installation
npx -y @yolfi/agent help
Les environnements compatibles MCP peuvent exécuter :
npx -y @yolfi/agent mcp
Règles de sécurité
Automatiser les paiements ne doit pas signifier automatiser les décisions financières à l'aveugle.
Les agents doivent demander à l'utilisateur avant de choisir :
- les adresses des portefeuilles de règlement ;
- les noms de produits ;
- les prix ;
- les devises ;
- les intervalles de paiements récurrents ;
- les actions destructives, comme la désactivation de liens de paiement ;
- l'endroit où les secrets doivent être stockés.
Les agents ne doivent pas considérer une redirection dans le navigateur comme une confirmation de paiement. Ils doivent vérifier le statut du paiement ou les événements webhook.
Webhooks
Yolfi signe les événements webhook afin que l'application réceptrice puisse vérifier que l'événement vient bien de Yolfi.
Les agents doivent ajouter la vérification de signature avant d'attribuer des crédits, de débloquer des fonctionnalités ou de marquer des commandes comme payées. Les détails d'implémentation doivent rester dans la documentation officielle et les exemples du paquet, pas dans des instructions improvisées à l'intérieur de l'application cible.
Liens
- Yolfi Agent Kit
- Documentation Yolfi
- GitHub
- npm
- Répertoires MCP : disponibles après examen des exigences de chaque répertoire
