Pagos agénticos con x402, lo que un builder debe saber sobre APIs pagadas por máquinas

Los agentes llevan un año pudiendo llamar herramientas, escribir código y leer APIs. Pagar no han podido nunca. Toda API de pago exige una cuenta, una tarjeta de crédito, un proceso KYC y una API key, y ese es justo el muro contra el que se para un agente autónomo. x402 derriba ese muro. Coinbase lanzó el protocolo en mayo de 2025, y ahora lo sostiene la x402 Foundation junto con Cloudflare. La idea es casi vergonzosamente simple: el código de estado HTTP 402 "Payment Required" está en el estándar web desde el principio y nunca se usó. x402 lo convierte en una petición de pago que un agente responde directamente dentro de una petición web normal. Vamos a recorrerlo desde el concepto hasta el servidor MCP.

Paso 1, entender qué resuelve x402 de verdad

Imagina que tu agente quiere acceder a una API del tiempo que cuesta un céntimo por consulta. Hoy eso significa que antes creas una cuenta, guardas una tarjeta, compras créditos y le das al agente una key. Cuatro pasos manuales, todos antes de la primera petición. Con x402 eso desaparece por completo. El agente simplemente llama a la API, recibe un "402 Payment Required", paga en el mismo gesto y obtiene la respuesta. Sin cuenta, sin login, sin sesión. Ese es el núcleo: x402 desplaza el pago del onboarding previo a la propia petición.

Paso 2, recorrer una vez el flujo de pago a mano

Antes de escribir una línea de código, repasa la secuencia mentalmente una vez, eso te ahorra horas de depuración después. El flujo tiene siete estaciones. El cliente manda una petición normal. El servidor responde con 402 y adjunta en el cuerpo de la respuesta los datos de pago, o sea importe, dirección del destinatario y cadenas aceptadas. El cliente construye con su wallet un pago firmado. Manda la petición otra vez, esta vez con el pago firmado en la cabecera X-Payment. El servidor verifica el pago, o él mismo o mediante un facilitator. El pago se liquida on-chain. El servidor entrega el recurso de verdad. Cuando has interiorizado esos siete pasos, el resto ya solo es tooling.

Paso 3, elegir la cadena y la moneda adecuadas

x402 es agnóstico de cadena, pero no funciona igual de bien en todas partes. La base de despliegue con diferencia más activa es Base, la propia cadena layer-2 de Coinbase, porque allí las comisiones de gas son casi cero y los micropagos de céntimos solo tienen sentido así. Solana y Polygon también están soportadas. Se paga por lo general con stablecoins, casi siempre USDC, para que el agente no tenga que lidiar con cotizaciones volátiles. Para empezar coge Base más USDC, es el camino mejor documentado y el que dan por hecho la mayoría de los ejemplos.

Paso 4, hacer que una API sea de pago

En el lado del servidor x402 es sorprendentemente poco código. En un entorno Node pones un middleware delante de tu ruta. En esencia el patrón se ve así:

import { paymentMiddleware } from "x402-express";

app.use(
  paymentMiddleware("0xTuDireccionDeDestino", {
    "/premium-data": "$0.01",
  })
);

El middleware asume todo lo pesado, genera la respuesta 402 cuando no hay pago, verifica los pagos entrantes y solo libera la ruta cuando se ha pagado. En el nivel más simple no tienes que hacer más. El paquete npm x402 es lo bastante estable para experimentos de verdad, el número exacto de versión míralo en npm, cambia a menudo.

Paso 5, entender el facilitator

El término facilitator aparece en toda la documentación de x402 y confunde al principio. Un facilitator es un servicio que ejecuta y verifica realmente el pago on-chain, para que tu servidor no tenga que hacerlo él contra la blockchain. Coinbase opera uno de esos facilitators, que liquida el pago e incluso asume la comisión de gas para el comprador. También puedes verificar los pagos en local, pero para empezar coge el facilitator, porque te quita de encima toda la interacción con la blockchain. Quédate con los papeles: el cliente paga, el servidor exige, el facilitator liquida, la blockchain es la capa de liquidación.

Paso 6, el lado del agente con x402-fetch

Ahora el lado comprador. Tu agente no debería reaccionar a un 402 con un error, sino pagar automáticamente. Para eso está x402-fetch, un envoltorio fino alrededor del fetch normal. Le das una wallet, y a partir de ahí trata un 402 no como una interrupción sino como una petición de pago. El wrapper construye el pago firmado, pone la cabecera X-Payment y manda la petición automáticamente una segunda vez. Para el código de tu agente eso parece una llamada a API totalmente normal que simplemente funciona. Ese es justo el asunto, la lógica de pago desaparece detrás del wrapper de fetch.

Paso 7, llevar x402 a un servidor MCP

Para la Academy la parte más interesante es la conexión con MCP. Si ya has construido un servidor MCP, sabes que las herramientas hasta ahora son gratis, quien instala el servidor usa todas las herramientas sin pagar. Con x402-mcp, todavía temprano en la versión 0.1.1, puedes hacer de pago herramientas concretas. Una herramienta que hace un cálculo caro o que tira de un servicio de terceros de pago exige entonces un micropago por llamada. Eso es una capa de monetización de verdad para servidores MCP, que se apaña sin Stripe, sin suscripción y sin cuentas de usuario. Pero trata la versión como lo que es, un paquete temprano. Para un producto todavía no lo pondría en marcha, para aprender es ideal.

Paso 8, poner límites antes de que el agente vacíe la cuenta

Aquí está la parte que en los posts de marketing se suele callar. Un agente que puede pagar de forma autónoma también puede pagar de más de forma autónoma. En el cuarto trimestre de 2025 hubo el experimento de meme coin PING, que abusó de x402 como si fuera un juego, más de 150.000 transacciones en el primer mes, porque la gente repitió cientos de veces el bucle de pago en Base gracias a las comisiones de gas nulas. Justo esa repetibilidad es el riesgo. Antes de darle una wallet a un agente, pon límites duros. Un límite diario en la wallet, un máximo por petición, y en el mejor de los casos una wallet aparte con solo unos pocos USDC en vez de tu wallet principal. Trata la wallet del agente como una tarjeta prepago, nunca como una cuenta corriente.

Paso 9, AP2 y el cuadro más amplio

x402 no está solo. Se incorporó a AP2, el Agents Payment Protocol impulsado por Google. Eso es relevante porque convierte x402 de un proyecto de Coinbase en un estándar con respaldo más amplio, y eso reduce el riesgo de construir sobre algo que dentro de un año esté muerto. En paralelo varias fuentes informan de que los pagos agénticos están entrando directamente en ChatGPT y Claude vía MCP. Hoy no tienes por qué usar AP2, pero deberías saber que x402 no es un capricho cripto aislado sino parte de una ola de estandarización para servicios pagados por máquinas.

Paso 10, cuándo NO necesitas x402

El paso más honesto para el final. x402 es una solución para un problema concreto, el pago autónomo máquina a máquina de importes pequeños sin cuenta. Si le cobras a personas 19 euros al mes, Stripe sigue siendo la herramienta correcta, no x402. Si tu API la usan socios comerciales conocidos con contratos, no necesitas micropagos on-chain. x402 brilla donde fluyen muchos importes pequeños entre partes que no se conocen de antes, APIs de pago por llamada, herramientas MCP de pago, consultas de datos de céntimos. No lo metas porque es nuevo, mételo cuando tu caso de uso sea exactamente ese.

Qué sigue

Si el paso 7 te ha parecido interesante, empieza con un servidor MCP propio y haz de pago primero solo una de sus herramientas. El playbook Primer servidor MCP en 90 minutos te pone la base, y Seguridad de MCP por stdio te enseña a qué prestar atención en cuanto hay dinero de por medio. Quien quiera profundizar en arquitectura de agentes, para ese el nivel 5 a partir de Qué es un agente es la entrada correcta.

Fuente

• Página oficial y whitepaper de x402, https://x402.org
• Coinbase Developer Platform, documentación de x402, https://docs.cdp.coinbase.com/x402/welcome
• Zuplo, pagos autónomos de API y de servidores MCP con x402, https://zuplo.com/blog/mcp-api-payments-with-x402
• Paquetes npm x402, x402-fetch, x402-mcp (a fecha 2026-06), los números exactos de versión cambian a menudo, compruébalos en npmjs.com antes de usarlos