Services - x402 : la couche de paiement des API et des agents IA
x402 transforme le code de statut HTTP 402, réservé depuis toujours, en véritable rail de paiement : n’importe quel endpoint d’API peut facturer des stablecoins à la requête, et n’importe quel client, humain ou agent IA, peut payer en un aller-retour. Nous l’intégrons de bout en bout : rendre vos endpoints payants, et donner à vos agents les moyens de dépenser.
Le protocole - Le paiement, composante native de HTTP
Le code de statut HTTP 402 Payment Required est réservé depuis 1997 sans jamais avoir servi. x402 l’active enfin : un standard ouvert, créé chez Coinbase et désormais porté par la x402 Foundation sous l’égide de la Linux Foundation, qui permet à tout serveur HTTP de facturer une requête et à tout client HTTP de la payer, en stablecoins, en un seul aller-retour.
Un serveur qui veut facturer répond simplement à une requête non payée par 402 Payment Required et la liste, lisible par une machine, des paiements acceptés : le prix, le jeton (typiquement de l’USDC), le réseau et l’adresse de réception. Le client signe une autorisation de paiement, rejoue la même requête avec un en-tête de paiement, et récupère la ressource accompagnée du hash de la transaction on-chain. Pas de page de paiement, pas de création de compte, pas de clé d’API à provisionner.
Comme tout l’échange est du HTTP ordinaire, il fonctionne pour les humains, les backends et, surtout, pour les agents IA, qui peuvent détenir un wallet et acheter exactement les données ou le calcul dont ils ont besoin, requête par requête, sans qu’un humain saisisse une carte. Le règlement est on-chain (Base, Solana et d’autres réseaux), prend quelques secondes et ne coûte aucun frais de protocole.
- Frais de protocole sur chaque paiement
- $0
- Compte, clé d’API ou formulaire de carte
- 0
- Aller-retour HTTP pour être payé en USDC
- 1
Sous le capot - Une requête, un paiement, une réponse
Trois acteurs entrent en jeu : l’acheteur (un utilisateur, un backend ou un agent IA), votre serveur d’API, et un facilitateur, un service sans état qui vérifie les paiements signés et les règle on-chain, de sorte que votre serveur ne touche jamais un nœud blockchain ni ne détient de clés.
La signature de l’acheteur autorise le transfert du montant exact annoncé en USDC (via EIP-3009 transferWithAuthorization), donc les fonds ne bougent que si votre serveur livre, l’acheteur ne paie pas de gas, et le facilitateur n’a jamais la garde de quoi que ce soit.
Cas d’usage - Ce que vous pouvez construire avec
x402 fait de chaque appel HTTP tarifé un produit à part entière. Il brille partout où abonnements, facturation ou frais de carte rendent absurdes les petits achats et ceux passés par des machines.
- Monétisation d’API. Facturez à l’appel plutôt que de vendre des sièges et des quotas. Une requête météo à 0,001 $, un appel d’inférence à 0,01 $, sans infrastructure de facturation à maintenir.
- Commerce agentique. Donnez un wallet à vos agents IA et ils achètent données, outils et calcul de façon autonome. x402 est le rail de paiement derrière les frameworks d’agents et les serveurs d’outils MCP.
- Contenu payant. Vendez un seul article, jeu de données ou vidéo pour quelques centimes, à des lecteurs anonymes du monde entier, sans imposer de compte ni d’abonnement.
- Services à l’usage. Mesurez calcul, stockage ou bande passante et facturez exactement ce qui a été consommé grâce au schéma « upto » du protocole.
- Facturation de machine à machine. Des microservices qui se paient à la requête au-delà des frontières d’entreprise, avec un règlement en quelques secondes au lieu de factures à 30 jours.
- Proxys et agrégateurs. Encapsulez des API payantes en amont, ajoutez votre marge et revendez-les via un endpoint x402 unique que les agents peuvent découvrir et payer par programmation.
Pourquoi c’est important - Ce que x402 change
Les rails de paiement traditionnels ont été conçus pour des humains qui achètent à la caisse. x402 redessine la transaction autour de la requête elle-même.
- Aucun parcours d’inscription. Les acheteurs ont besoin d’un wallet approvisionné, rien d’autre. Pas d’inscription, pas de formulaire KYC pour un achat à 0,005 $, pas de clé d’API à provisionner, renouveler, puis laisser fuiter.
- De vrais micropaiements. Sur les rails carte, tout achat sous ~1 $ est à perte. Avec des transferts USDC sans frais, des prix à la fraction de centime deviennent des modèles économiques viables.
- Un règlement instantané et définitif. Les fonds arrivent dans votre wallet en quelques secondes et ne peuvent pas faire l’objet d’un rejet de débit. Pas de cycle de versement à 30 jours, pas de réserve glissante, pas de gestion de litiges.
- Mondial par défaut. Un paiement en stablecoin fonctionne de la même façon depuis tous les pays, sans acquéreur local, conversion de devise ni prestataire restreint à une région.
- Conçu pour les machines. La réponse 402 est lisible par une machine : le logiciel négocie et paie sans humain dans la boucle. C’est la primitive qui manquait à l’économie des agents.
- Ouvert et neutre. Un standard ouvert de la Linux Foundation, plusieurs facilitateurs, des SDK en TypeScript, Go et Python, et aucune dépendance à un fournisseur ni rente de protocole.
Intégration - Un aperçu des deux côtés
Vendre, c’est un middleware sur votre serveur existant. Acheter, c’est envelopper votre client HTTP avec un wallet. Tout le reste — le handshake 402, la signature, le rejeu, le règlement — est pris en charge par les SDK du protocole.
Vendre : rendre un endpoint payant
import express from 'express'
import { paymentMiddleware, x402ResourceServer } from '@x402/express'
import { ExactEvmScheme } from '@x402/evm/exact/server'
import { HTTPFacilitatorClient } from '@x402/core/server'
const app = express()
const facilitator = new HTTPFacilitatorClient({ url: 'https://x402.org/facilitator' })
app.use(
paymentMiddleware(
{
'GET /api/report': {
accepts: [
{ scheme: 'exact', price: '$0.01', network: 'eip155:8453', payTo: '0xYourAddress' },
],
description: 'Market report, paid per request',
},
},
new x402ResourceServer(facilitator).register('eip155:8453', new ExactEvmScheme()),
),
)
app.get('/api/report', (req, res) => res.json({ report: '...' }))Acheter : payer à la requête
import { wrapFetchWithPayment } from '@x402/fetch'
import { x402Client } from '@x402/core/client'
import { ExactEvmScheme } from '@x402/evm/exact/client'
import { privateKeyToAccount } from 'viem/accounts'
const signer = privateKeyToAccount(process.env.EVM_PRIVATE_KEY)
const client = new x402Client()
client.register('eip155:*', new ExactEvmScheme(signer))
const fetchWithPayment = wrapFetchWithPayment(fetch, client)
// The 402 response, USDC authorization, and retry are handled for you
const response = await fetchWithPayment('https://api.example.com/api/report')