12k
All articles

Doter votre agent IA d'un portefeuille

Explorez les portefeuilles d’agents, les contrôles Cloudflare Wallets et les paiements x402 sur HTTP. Découvrez les fonctions disponibles et les limites encore floues.

OpenReplay Team
OpenReplay Team
Doter votre agent IA d'un portefeuille

Un portefeuille d’agent (agent wallet) est un solde délimité qu’un agent IA peut dépenser pour le compte de son propriétaire, dans les limites fixées par ce dernier. Il permet à l’agent de payer des API, des outils et du contenu sans jamais détenir la carte bancaire du propriétaire.

Vous avez sans doute déjà vu un agent se heurter à ce problème. Il lit la documentation, choisit le bon endpoint, rédige la requête, puis s’arrête net devant un formulaire d’inscription qui exige une carte bancaire. Le reste du travail vous revient.

Cloudflare Wallets, annoncé le 4 août 2026, est une illustration concrète de cette idée. Cet article explique ce qu’est un portefeuille d’agent, quels contrôles Cloudflare a décrits, comment un paiement transite via HTTP et quelles questions restent ouvertes. Il montre la direction que prennent les paiements agentiques. Il ne s’agit pas d’une recommandation de les utiliser en production : le produit en est à ses débuts et pourrait évoluer ou être retiré.

Points clés

  • Dans la documentation de Cloudflare Wallets, mise à jour pour la dernière fois le 19 août 2026, la seule fonctionnalité opérationnelle est la réservation d’un identifiant (handle) sur cloudflare.pay, et un identifiant réservé ne peut ni envoyer, ni recevoir, ni détenir de fonds.
  • Cloudflare décrit deux types de portefeuilles : les Account Wallets, détenus par les personnes propriétaires d’un compte Cloudflare, et les Virtual Wallets, que les agents utilisent au moyen de clés d’API.
  • Les garde-fous annoncés pour un Virtual Wallet sont une enveloppe de dépenses, une liste de marchands autorisés et un montant maximal par transaction, auxquels s’ajoute une intervention manuelle par un humain. Ni l’annonce ni la documentation ne décrivent d’expiration ou d’API de révocation.
  • x402 associe un paiement à une requête HTTP ordinaire en réutilisant le code de statut 402 Payment Required, ce qui permet à un agent de payer un appel d’API unique sans créer de compte.
  • La réservation d’un identifiant est gratuite. Aucune tarification n’a été publiée pour les portefeuilles eux-mêmes.

Pourquoi confier votre carte bancaire à un agent ne fonctionne pas

Un numéro de carte confère à un agent bien plus de pouvoir qu’aucune tâche n’en exige. Il n’offre aucune restriction par marchand, aucun budget par tâche et aucune traçabilité indiquant quel agent a dépensé quoi. Le seul moyen de retirer ce pouvoir est de faire opposition sur la carte, ce qui interrompt aussi tous les autres prélèvements qui y sont associés.

Les agents qui naviguent et agissent pour vous se heurtent constamment à ce problème. L’annonce de Cloudflare pointe deux éléments manquants : les agents n’ont pas d’identifiant fixe pour s’inscrire, ni de moyen de paiement qui leur soit propre. L’agent s’arrête donc généralement et renvoie l’inscription, le paiement et les clés d’API à un humain. Il lui est ainsi difficile de tester et de comparer seul de nombreux services payants.

Ce qu’est un portefeuille d’agent : Account Wallets et Virtual Wallets

Un portefeuille d’agent dissocie l’argent du pouvoir de le dépenser. Un humain détient les fonds, et chaque agent reçoit une part limitée qu’il peut dépenser de manière autonome. La conception de Cloudflare repose sur deux niveaux.

Type de portefeuilleDétenu parFonctionnement
Account WalletLes humains propriétaires ou utilisateurs du compte CloudflarePermettra d’alimenter le solde, de déléguer des dépenses aux Virtual Wallets et de retirer de l’argent ; peut détenir un identifiant cloudflare.pay
Virtual WalletLes agentsLes agents l’utilisent avec une clé d’API ; il ne peut pas dépenser au-delà du plafond fixé par le propriétaire de l’Account Wallet

La documentation de Cloudflare Wallets indique que l’objectif des Virtual Wallets est de permettre à un agent de travailler sans qu’un humain valide chaque étape, tout en imposant un plafond strict à ses dépenses. Selon l’annonce, les agents s’en serviront pour acheter des API, du contenu et des outils MCP, ces mêmes outils côté serveur présentés dans notre guide de l’écosystème MCP.

L’essentiel n’est pas encore disponible :

DisponibleAnnoncéNon décrit dans l’annonce ni dans la documentation
Réservation d’un identifiant par compte (gratuite), qui publie une page à l’adresse HANDLE.cloudflare.pay et vous inscrit aux notifications de lancementAlimentation, envoi, réception et détention de fonds ; Virtual Wallets ; garde-fous ; intervention manuelle ; identité propre à chaque agentTarification des portefeuilles, dates de lancement, expiration, API de révocation, comportement en cas de concurrence, procédure de contestation d’un achat par l’acheteur

La FAQ de Wallets ajoute quelques conditions. Réserver un identifiant ne garantit pas l’accès à un portefeuille lors du lancement. Une fois réservé, un identifiant ne peut être ni modifié, ni libéré, ni transféré. Cloudflare peut refuser ou récupérer des réservations. Le communiqué de presse indique que l’accès complet aux portefeuilles arrivera « dans les prochains mois », sans date précise.

Quels contrôles offre un portefeuille d’agent, et que manque-t-il ?

L’annonce de Cloudflare énumère trois garde-fous qu’un propriétaire configure sur un Virtual Wallet, ainsi qu’une intervention manuelle lorsqu’un agent atteint sa limite. Aucun n’est encore opérationnel. La documentation ne mentionne que des « permissions » et une limite de dépenses, sans nommer les contrôles individuels.

ContrôleCe qu’il limiteCe qu’il ne peut pas exprimer
Enveloppe de dépensesLe montant total dépenséLa pertinence de ces dépenses
Liste de marchands autorisésLes bénéficiaires que l’agent peut payerQuels articles, ni à quelle fréquence
Montant maximal par transactionLe montant de chaque paiementUne multitude de petits paiements qui s’additionnent
Intervention manuellePermet à un humain habilité de relever la limite ou d’approuver des fonds supplémentairesLe moment où une dérogation doit expirer

Ni l’annonce ni la documentation de Cloudflare ne décrivent de date d’expiration pour le pouvoir de dépense d’un agent, ni d’API pour le révoquer. Cloudflare indique également qu’un humain pourra examiner les activités inhabituelles, comme des dépenses anormalement rapides. Il s’agit d’une intention affichée, pas d’un contrôle documenté : aucun déclencheur ni mécanisme n’a été publié.

Comment un agent paie : x402 et HTTP 402

x402 est un protocole ouvert qui associe un paiement à une requête HTTP. Il réutilise le code de statut 402 Payment Required, réservé de longue date par HTTP mais jamais défini en pratique. L’article de Cloudflare sur Monetization Gateway décrit le flux comme suit :

  1. L’agent demande une ressource à un endpoint compatible x402.
  2. Le serveur répond par un 402, en indiquant le prix et les modalités de paiement.
  3. L’agent paie et renvoie sa requête, en y joignant cette fois une preuve de paiement.
  4. Un facilitateur vérifie le paiement, puis le serveur renvoie la ressource demandée.

Les portefeuilles de Cloudflare effectueront dans un premier temps leurs règlements en stablecoins. C’est un choix de Cloudflare, pas une exigence de x402. Monetization Gateway a lui-même été ouvert sous forme de liste d’attente lors de son annonce par Cloudflare.

Un identifiant cloudflare.pay permet aussi aux marchands de savoir qui paie, puisqu’il indique à quelle organisation appartient un agent. L’exemple donné dans l’annonce est celui d’un agent de recherche à l’adresse research.example.cloudflare.pay. Déclarer cette identité sera facultatif pour l’agent, et chaque marchand décidera s’il traite différemment les agents identifiés.

Qui est responsable lorsqu’un agent achète la mauvaise chose ?

Aucune source publiée n’indique encore qui est responsable lorsqu’un agent achète la mauvaise chose. Les sources laissent trois questions en suspens.

Qu’advient-il des rétrofacturations (chargebacks) ? L’article sur Monetization Gateway présente le règlement en stablecoins comme exempt de rétrofacturation, les fonds allant directement au vendeur. Ni l’annonce de Wallets ni la documentation n’expliquent comment un acheteur peut contester un achat erroné effectué par un agent.

Que consigne la piste d’audit ? Un journal de paiements indique ce qui a été payé. Aucune des sources ne décrit d’enregistrement expliquant pourquoi l’agent a choisi de payer.

À qui incombe l’erreur ? Il pourrait s’agir du propriétaire du compte, du concepteur de l’agent ou du marchand. Les sources ne le précisent pas.

L’analyse du lancement publiée par InfoQ soulève un point structurel : ces contrôles fixent un budget, mais ne constituent pas une politique. Chaque vérification compare un paiement isolé à une valeur fixe. Aucun d’eux ne peut donc exprimer une règle telle que « ne pas acheter deux fois le même jeu de données cette semaine », car cette règle dépend des paiements antérieurs. InfoQ évoque aussi la question de la concurrence. Si un agent envoie plusieurs paiements simultanément, chacun pourrait être vérifié par rapport à l’enveloppe complète avant que les autres n’en aient été déduits, si bien que le total pourrait dépasser la limite. Cloudflare n’a pas publié le comportement de l’enveloppe dans ce cas de figure.

La course plus large aux paiements agentiques

Cloudflare n’est pas la seule entreprise à développer des paiements agentiques : le protocole x402 de Coinbase et le portefeuille Link pour agents de Stripe abordent le même problème de manières différentes. x402 a été créé par Coinbase puis confié à la Linux Foundation. La x402 Foundation est devenue opérationnelle en juillet 2026 avec 40 membres.

Stripe a adopté l’approche inverse. À son lancement, son portefeuille Link pour agents ne fournit à un agent une carte à usage unique ou un Shared Payment Token qu’après approbation de chaque demande de dépense par l’utilisateur. Stripe annonce l’ajout ultérieur de limites définies par l’utilisateur. Les paiements ne sont qu’une couche parmi d’autres dans l’outillage des agents, aux côtés de solutions comme Docker MCP pour les agents IA et WebMCP, qui permet à un site d’exposer ses propres actions aux agents.

Conclusion

Un portefeuille d’agent remplace le « voici ma carte » par une délégation de pouvoir encadrée. Dans la version de Cloudflare, ces limites s’appliquent paiement par paiement, et la responsabilité, les contestations et la gestion de la concurrence ne sont pas encore documentées. Tant que l’alimentation des portefeuilles et les paiements ne sont pas disponibles, la seule démarche concrète possible consiste à réserver un identifiant. D’ici là, si vous développez des agents, déterminez où doivent résider vos propres règles de dépenses : dans le portefeuille, ou dans votre application.

FAQ

x402 fonctionne-t-il uniquement avec Cloudflare ou avec des stablecoins ?

Non. x402 est un standard ouvert de paiement via HTTP. Créé par Coinbase, il est désormais régi par la x402 Foundation, placée sous l'égide de la Linux Foundation. La fondation a été lancée avec 40 membres, dont AWS, Google, Stripe, Visa, Mastercard et Cloudflare. Selon la Linux Foundation, x402 prend en charge des moyens de paiement allant des cartes bancaires traditionnelles aux stablecoins. Cloudflare a choisi les stablecoins pour ses propres portefeuilles, mais le protocole ne les impose pas.

Le code HTTP 402 Payment Required est-il un code de statut officiel ?

Oui, mais la spécification ne définit pas son comportement. La RFC 9110, qui définit la sémantique HTTP, indique que le code 402 est réservé à un usage futur, et MDN précise qu'il n'existe aucune convention standard à son sujet. Les navigateurs et les clients HTTP le traitent comme n'importe quelle autre erreur client 4xx. x402 apporte cette convention manquante : le contenu de la réponse 402, la manière dont le client paie et la façon dont il renvoie sa requête avec une preuve de paiement.

Quelle est la différence entre Cloudflare Wallets et le portefeuille Link pour agents de Stripe ?

Ils placent l'approbation humaine à des étapes différentes. Selon Cloudflare, les Virtual Wallets permettront aux agents de dépenser de manière autonome, dans le cadre d'une enveloppe, d'une liste de marchands autorisés et d'un montant maximal par transaction définis à l'avance. Lors de son lancement en avril 2026, le portefeuille Link pour agents de Stripe ne fournit à un agent une carte à usage unique ou un Shared Payment Token qu'après approbation de chaque demande de dépense par l'utilisateur. Stripe annonce que des limites définies par l'utilisateur suivront.

Comment appliquer des règles de dépenses que les limites d'un portefeuille d'agent ne peuvent pas exprimer ?

Ajoutez dans votre propre application une vérification de politique exécutée avant que l'agent ne paie. Tenez un registre des achats passés afin que cette vérification puisse rejeter les doublons, comme l'achat du même jeu de données deux fois dans la même semaine. Faites en sorte que la vérification réserve les fonds de manière atomique, par exemple au moyen d'une transaction de base de données ou d'une file de paiement par agent. Cela empêche des paiements parallèles d'être tous validés sur la base de la même enveloppe non encore entamée.

Understand every bug

Uncover frustrations, understand bugs and fix slowdowns like never before with OpenReplay — self-hosted, with full data ownership.

Star on GitHub

We use cookies to improve your experience. By using our site, you accept cookies.