Clawy / Guías / Qué es x402

¿Qué es x402?

Un protocolo abierto que convierte "HTTP 402 Payment Required" — el código de estado que estuvo sin usar durante 30 años — en pagos reales. Permite que un programa pague una llamada API con stablecoins, sin cuenta y sin clave API.

Hoy cada API restringe el acceso con una clave API que registras, almacenas y facturas contra un plan mensual. Eso funciona para humanos que hacen clic en un panel. Para el software es fricción — especialmente para agentes de IA que necesitan llamar a un servicio una vez, pagar exactamente eso y seguir. x402 elimina la cuenta por completo: el precio está en la respuesta y el cliente paga por petición.

El flujo, en tres pasos

El cliente llama al endpoint sin pago. El servidor responde 402 Payment Required e incluye el precio y dónde pagar (en una cabecera).

El cliente firma un pago en stablecoin por ese importe exacto — normalmente USDC en Base — usando una autorización EIP-3009 (una firma, sin transacción on-chain del cliente).

El cliente reintenta la misma petición con el pago firmado en una cabecera X-PAYMENT. Un facilitador lo liquida on-chain y el servidor devuelve 200 OK con el resultado.

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": [ ... ] }

Por qué importa para los agentes de IA

Sin registro, sin gestión de claves. Un agente puede descubrir un servicio y pagarlo de forma autónoma, sin que un humano cree antes una cuenta.
Paga exactamente por lo que usas. Una llamada, un micropago — sin mínimo de $20/mes para hacer tres peticiones.
Descubrimiento legible por máquina. Los servicios x402 publican manifiestos (`/.well-known/x402.json`, `/llms.txt`) para que los agentes los encuentren y consulten precios programáticamente.

Es temprano — el ecosistema de agentes que pagan aún se está formando — pero es la respuesta más limpia que existe hoy a "cómo paga un programa a otro por una sola llamada".

Preguntas frecuentes

¿Es una transacción de blockchain en cada llamada? El cliente solo firma; un facilitador agrupa/liquida. El comprador necesita una wallet con fondos, no gas por llamada.

¿Cuánto cuesta aceptar? Recibes stablecoins en tu wallet; las comisiones del facilitador son pequeñas. Sin cuenta de procesador de pagos ni cuota mensual.

¿Qué cadenas? Base mainnet es la más común (USDC); algunos servicios admiten Solana y otras.

→ Llama a una en 5 minutos. Un cliente x402 completo para copiar y pegar (Node) que golpea un endpoint en vivo, firma el pago y obtiene una respuesta — empieza en un nivel de $0,04.

¿Quieres vender tú mismo una API con cobro por llamada? Dos cosas deciden si gana dinero: acertar con la integración y ponerle precio para que los costes de tokens no se coman tu margen.

→ Kit de precios de API de IA (19 €). Un modelo de coste/margen en Excel + código margin-guard listo para usar, para que un precio fijo por llamada nunca te cueste más de lo que cobras, además de una calculadora offline e inicio rápido.