Clawy / Guides / Qu'est-ce que x402

Qu'est-ce que x402 ?

Un protocole ouvert qui transforme "HTTP 402 Payment Required" — le code de statut resté inutilisé pendant 30 ans — en paiements réels. Il permet à un programme de payer un appel API avec des stablecoins, sans compte ni clé API.

Aujourd'hui, chaque API verrouille l'accès avec une clé API que vous créez, stockez et facturez sur un forfait mensuel. Cela marche pour les humains qui cliquent dans un tableau de bord. Pour un logiciel, c'est de la friction — surtout pour les agents d'IA qui doivent appeler un service une fois, payer exactement cela et passer à autre chose. x402 supprime entièrement le compte : le prix est dans la réponse, et le client paie par requête.

Le déroulé, en trois étapes

Le client appelle l'endpoint sans paiement. Le serveur répond 402 Payment Required et indique le prix et où payer (dans un en-tête).

Le client signe un paiement en stablecoin pour ce montant exact — généralement USDC sur Base — via une autorisation EIP-3009 (une signature, sans transaction on-chain du client).

Le client réessaie la même requête avec le paiement signé dans un en-tête X-PAYMENT. Un facilitateur le règle on-chain, le serveur renvoie 200 OK avec le résultat.

POST /v1/chat/opus            -> 402  (PAYMENT-REQUIRED: amount=150000, payTo=0x...)
   sign EIP-3009 for 0.15 USDC
POST /v1/chat/opus + X-PAYMENT -> 200  { "choices": [ ... ] }

Pourquoi c'est important pour les agents d'IA

Sans inscription, sans gestion de clés. Un agent peut découvrir un service et le payer de façon autonome, sans qu'un humain crée d'abord un compte.
Payez exactement ce que vous utilisez. Un appel, un micropaiement — pas de minimum de $20/mois pour faire trois requêtes.
Découverte lisible par machine. Les services x402 publient des manifestes (`/.well-known/x402.json`, `/llms.txt`) pour que les agents les trouvent et vérifient les prix par programmation.

C'est tôt — l'écosystème des agents qui paient se forme encore — mais c'est la réponse la plus propre qui existe aujourd'hui à "comment un programme en paie-t-il un autre pour un seul appel".

Questions fréquentes

Est-ce une transaction blockchain à chaque appel ? Le client se contente de signer ; un facilitateur regroupe/règle. L'acheteur a besoin d'un portefeuille approvisionné, pas de gas par appel.

Combien coûte l'acceptation ? Vous recevez des stablecoins sur votre portefeuille ; les frais du facilitateur sont faibles. Pas de compte de processeur de paiement ni de frais mensuels.

Quelles chaînes ? Base mainnet est la plus courante (USDC) ; Solana et d'autres sont prises en charge par certains services.

→ Appelez-en une en 5 minutes. Un client x402 complet à copier-coller (Node) qui appelle un endpoint en direct, signe le paiement et obtient une réponse — démarrez sur un niveau à $0,04.

Vous voulez vendre vous-même une API facturée à l'appel ? Deux choses déterminent si elle rapporte : réussir l'intégration et la tarifer pour que les coûts de tokens ne grignotent pas votre marge.

→ Kit de tarification d'API d'IA (19 €). Un modèle coût/marge Excel + code margin-guard prêt à l'emploi pour qu'un prix forfaitaire par appel ne vous coûte jamais plus que ce que vous facturez, plus un calculateur hors ligne et un démarrage rapide.