Guía 4 · Cobra a los agentes · Protocolo abierto · x402 Foundation (Cloudflare + Coinbase)
x402: el protocolo para que un agente pague
x402 convierte el viejo código HTTP 402 en un pago real: el servidor dice cuánto cuesta, el agente firma y repite el request. Sin cuentas, sin tarjetas, sin checkout.
Fuente: blog.cloudflare.com/x402
402 existía desde siempre
HTTP tiene un código 402 Payment Required reservado desde los 90. Nadie lo usaba porque no había cómo pagar dentro del request. x402 lo llena.
El flujo en cinco pasos
El agente pide algo. El servidor responde 402 y en el body: cuánto cuesta y a quién pagarle.
El flujo en cinco pasos
El agente repite el mismo request con una autorización de pago firmada en un header. Un facilitador verifica la firma y liquida el pago.
El flujo en cinco pasos
El servidor devuelve el recurso con un header de recibo. Todo pasó dentro de HTTP: sin registro, sin API key, sin redirect a un checkout.
Agents SDK de Cloudflare · withX402 / withX402Client
Un servidor MCP con caja registradora
Con el Agents SDK, un servidor MCP envuelto en withX402 puede exponer herramientas gratis y herramientas de pago (paidTool) con su precio.
Herramientas MCP que cobran
Del lado del agente, withX402Client atrapa el 402. El agente puede preguntarle al humano antes de pagar, o pagar solo dentro de un límite.
Herramientas MCP que cobran
Para probar sin plata real, Cloudflare tiene un playground con USDC de testnet en Base.
Propuesta de Cloudflare para la próxima versión de x402
No todo pago tiene que ser al instante
Cloudflare propuso un esquema diferido: el agente firma un compromiso con HTTP Message Signatures y recibe el recurso de una.
Pagar después: el esquema diferido
La liquidación pasa después, en lote: diaria, por suscripción, con tarjeta o con stablecoins.
Es una propuesta: la idea es que entre en la próxima versión mayor de x402.
Lo que hay que llevarse
- Qué es
Un protocolo abierto: HTTP 402 + un pago firmado en el mismo request.
- Por qué importa
Un agente no puede llenar un formulario con tarjeta. Sí puede firmar.
- Herramientas
Agents SDK: withX402 para cobrar, withX402Client para pagar.
Para agentes: esta guía en Markdown en /es/agentes/x402.md o pidiendo la misma URL con Accept: text/markdown.
Lucas Leguizamo · CTO, FreeTicket