x402 est un protocole permettant de payer des ressources web via HTTP. Un serveur renvoie les exigences de paiement avec HTTP 402 ; un client compatible autorise le paiement et réessaie avec une charge utile de paiement.
Pour un agent d'IA, cela peut transformer une consultation API payante en une partie de la tâche. Le portefeuille doit toujours avoir la permission de dépenser, et le service doit toujours livrer le résultat.
Le HTTP 402 devient une offre de prix
HTTP 402 est le code d'état Payment Required (paiement requis). x402 ajoute un échange de paiement défini autour de celui-ci ; les navigateurs ordinaires ne deviennent pas automatiquement des acheteurs autonomes parce qu'un site web renvoie cet état.
Dans le flux actuel V2, le serveur communique les exigences via PAYMENT-REQUIRED. Le client répond avec une charge utile de paiement en PAYMENT-SIGNATURE. Le serveur rapporte le résultat du règlement via PAYMENT-RESPONSE. Les noms d'en-têtes décrivent des étapes distinctes, et non trois paiements. HTTP 402 et en-têtes V2.
Imaginez un agent de recherche achetant une observation météo pour une tâche de planification d'itinéraire. Une offre fictive demande 0,001 USD en USDC, nomme l'adresse de réception du vendeur et spécifie un réseau pris en charge ainsi qu'un schéma de paiement exact. Le client de paiement doit reconnaître ces conditions avant de pouvoir procéder. Ce prix est illustratif, et non une cotation de service réelle.
Une offre de prix n'est pas une permission de dépenser. La politique du portefeuille ou de l'application doit vérifier que le montant, le marchand et la ressource demandée correspondent à la tâche. Un serveur peut proposer un prix déraisonnable tout comme un vendeur humain peut le faire.
D'une requête non payée à une réponse payée
L'agent autorise un paiement, tandis que le vendeur contrôle le moment où il libère la ressource.
Suivre une requête payante
Le client demande la ressource. Le serveur répond avec les exigences de paiement. Le client choisit une option prise en charge et crée une autorisation ou une charge utile de paiement pour cette option. Il répète la demande de ressource avec la charge utile jointe.
Le serveur vérifie le paiement et gère le règlement selon le schéma et le flux de paiement sélectionnés. L'autorisation par défaut est vérifiée avant le gestionnaire de ressource et réglée après ; un flux anticipé règle avant que le gestionnaire ne s'exécute. Les flux basés sur un séquestre introduisent des soldes financés et capturent ou effectuent un rachat ultérieur. Un prix exact seul ne vous indique pas quand le calcul commence par rapport au règlement. Aperçu du schéma et du flux de paiement.
La séparation est utile pour comprendre une défaillance. Une autorisation rejetée signifie que le service n'a pas accepté le paiement proposé. Une transaction diffusée en attente de confirmation signifie que l'argent peut encore être transféré. Un paiement complété avec une ressource manquante est un problème de livraison.
Une interface qui fusionne ces états en « échec de paiement » encourage des tentatives répétées coûteuses. Le client doit préserver l'identité de la requête et réconcilier la tentative précédente avant d'autoriser un autre achat. Un logiciel peut répéter un passage en caisse erroné beaucoup plus rapidement qu'un humain.
Le facilitateur gère la tuyauterie du paiement
Un facilitateur peut vérifier les charges utiles de paiement, soumettre les transactions de règlement et signaler leur statut. Un serveur de ressources peut utiliser un fournisseur de production géré, exploiter son propre service ou gérer ces fonctions lui-même. Le facilitateur de démarrage rapide public ne doit pas être considéré comme la route de production pour chaque réseau. Documentation du facilitateur.
Le facilitateur sélectionné affecte les dépendances opérationnelles du service. Le vendeur a besoin d'un support pour son réseau, son jeton et son schéma de paiement. Il a également besoin d'une réponse exploitable lorsque le fournisseur est lent ou indisponible.
La vérification non-custodiale ne rend pas chaque partie de l'entreprise indépendante. Un fournisseur peut être incapable de soumettre des transactions sans détenir les fonds du client. Une passerelle API peut cesser de fournir des ressources sans contrôler le portefeuille. Ces défaillances appartiennent à différentes parties du plan d'incident.
Avant de lancer un point de terminaison payant, je testerais la route avec le fournisseur de production et la configuration réelle du contrat. Un paiement réussi sur le testnet établit que l'intégration peut fonctionner dans cet environnement. Cela n'établit pas la liquidité, la tarification ou la fiabilité de production.
Le schéma change lorsque l'argent circule
Un paiement exact spécifie un montant défini. Un paiement « up-to » autorise un plafond d'utilisation dont le coût final peut être inférieur. Le règlement par groupage regroupe les frais pour un rachat ultérieur sur la blockchain, tandis que l'autorisation-capture prend en charge un modèle avec séquestre et remboursable. Ce sont des choix différents pour un vendeur facturant au paiement à la requête ou par unité de travail. Schémas de paiement.
Une recherche de données à prix fixe correspond à un problème de facturation différent de la génération d'une réponse dont le coût de calcul dépend de la longueur de la sortie. Ce dernier nécessite un maximum clair et une charge finale mesurable. L'acheteur devrait savoir comment le vendeur calcule cette charge.
Dans le modèle de groupage EVM documenté, l'acheteur finance le séquestre et signe des bons cumulatifs. Le vendeur peut réclamer plus tard et balayer les produits via une opération de règlement distincte. Cela explique comment les frais différés peuvent rester collectables, tout en ajoutant des règles de financement et de rachat à inspecter. Mécanisme de règlement par groupage.
C'est pourquoi un million de requêtes payantes ne devrait pas être automatiquement décrit comme un million de transactions sur la blockchain. L'article sur l'économie des micropaiements suit les coûts à chaque couche plutôt que d'utiliser le nombre de requêtes comme indicateur du revenu de la chaîne.
Un modèle d'IA n'est pas le signataire du paiement
Le modèle peut décider qu'une ressource est utile et transmettre une demande d'achat à un outil. Un service de portefeuille ou un composant de signature crée l'action financière autorisée. Ces rôles devraient être visibles dans la conception du système.
Donner au modèle une instruction de tâche telle que « dépenser avec discernement » offre une protection plus faible qu'une limite de transaction imposée. Une configuration plus robuste vérifie le marchand, la devise, le montant maximum et le budget restant avant que le signataire n'approuve la requête.
Il existe également une différence entre un achat unique et une autorisation continue. Un paiement pour une ressource ne devrait pas accorder discrètement à un vendeur l'accès à un solde sans restriction. Notre article sur les portefeuilles d'agents explique comment la conservation et les permissions de dépenses façonnent cette limite.
L'identité de l'agent est une autre question distincte. Un paiement prouve une action financière sous le mécanisme pertinent. Il ne prouve pas que l'acheteur est un agent d'IA unique, compétent ou honnête. L'ERC-8004 concerne l'identification et les signaux de confiance autour des agents, plutôt que de remplacer l'échange de paiement.
Le paiement et la livraison utile nécessitent des reçus
Le service doit identifier clairement la ressource et l'unité de tarification. « Une réponse » peut signifier un résultat de recherche, un ensemble de données complet ou une page d'enregistrements. Une facturation ambiguë rend la comparaison difficile tant pour les humains que pour les agents.
Les offres signées et les reçus peuvent aider à lier un achat aux conditions déclarées et à un résultat enregistré. Ils ne prouvent toujours pas que chaque fait dans un ensemble de données livré est correct. Un acheteur a besoin d'un moyen d'évaluer la fraîcheur, la provenance et si la réponse sert la tâche. Offres signées et reçus.
Pour un travail coûteux ou variable, définissez ce qui compte comme un succès facturable. Un résultat vide peut être une réponse valide à une requête, mais cette règle devrait être énoncée avant l'achat. Il en va de même pour un calcul échoué ou une source en amont indisponible.
Le problème de distribution du vendeur demeure. Activer x402 ne rend pas un point de terminaison découvrable ou digne d'être payé. La vente de données aux agents couvre ce côté du business.
Ce qu'il faut inspecter dans une démo x402
Recherchez une cotation visible, une autorisation contrainte et un résultat de règlement distinct. Demandez à l'équipe de tenter une requête après un délai d'attente simulé et de montrer que l'achat original n'est pas facturé deux fois. Demandez ensuite ce qui se passe si le paiement réussit mais que la réponse est perdue.
Une démo utile termine la tâche du client dans ces conditions. Une capture d'écran d'un explorateur de transferts prouve beaucoup moins. Un logiciel achetant une ressource a besoin d'un échange commercial fiable autour de la transaction.
Pour une approche alternative de protocole et d'intégration de marchand, lisez x402 vs MPP. Le choix commence par le modèle de facturation du service et les méthodes de paiement que ses clients peuvent utiliser.
Un délai d'attente nécessite deux réponses distinctes
Supposons qu'un vendeur ait accepté un paiement pour une observation météorologique, mais que le client n'ait jamais reçu la réponse. L'étape suivante dépend de deux enregistrements : l'achat a-t-il été réglé, et cette observation a-t-elle été livrée ?
Un achat réglé avec une réponse manquante nécessite un chemin de récupération de livraison. Une autorisation rejetée avant acceptation nécessite une explication de l'échec du paiement. Un paiement dont le résultat est encore inconnu nécessite une réconciliation avant une autre autorisation.
L'identifiant de paiement peut aider à relier une tentative répétée à l'achat original lorsque l'extension est implémentée. Le vendeur a toujours besoin d'une règle pour retourner ou récupérer la ressource achetée. Extension Payment-Identifier.