¿Qué es x402? El protocolo de pago HTTP 402 para agentes de IA

x402 es un protocolo de pago abierto que lleva los pagos dentro de las peticiones web normales. Cuando un cliente pide un recurso de pago, el servidor responde con el estado HTTP 402 (Payment Required) y un precio. El cliente, a menudo un agente de IA, firma un pago en stablecoins, normalmente en USDC, y envía otra vez la misma petición con el pago adjunto. No hay que crear una cuenta, gestionar una clave de API ni pasar por una página de pago.

Esta guía explica paso a paso cómo funciona x402, los términos que verás en la especificación, qué cambió en x402 V2, en qué redes funciona, cuánto cuesta y cuándo conviene más un checkout cripto normal. OrcaRail no ofrece pagos con x402 hoy, y al final del artículo explicamos qué ofrece en su lugar.

Qué es x402

x402 se presenta como un estándar abierto y neutral para pagos nativos de internet (x402.org). La documentación de x402 de Coinbase lo concreta más: x402 permite que un servidor cobre por un recurso en la misma petición con la que se obtiene (FAQ de x402).

El nombre viene del código de estado HTTP 402, Payment Required. El estándar HTTP define ese código pero lo deja sin uso: dice que está "reservado para uso futuro" (RFC 9110). x402 le da un trabajo real.

• Quién lo creó. Coinbase empezó el trabajo en x402 (anuncio de Cloudflare y Coinbase), y el protocolo se lanzó en mayo de 2025 (anuncio de x402 V2).
• Quién lo gestiona hoy. El 14 de julio de 2026, la Linux Foundation anunció el lanzamiento operativo de la x402 Foundation, un organismo de gobernanza abierta creado para dirigir el protocolo x402, que aportó Coinbase (anuncio).
• Dónde está el código. En github.com/x402-foundation/x402, con licencia Apache-2.0 y SDK para TypeScript, Python y Go.

Los datos del protocolo de este artículo vienen de x402.org, del repositorio de la x402 Foundation y de la FAQ de x402 de Coinbase, revisados el 12 de noviembre de 2026.

Cómo funciona x402, paso a paso

El repositorio describe el flujo típico. En resumen:

1. El cliente pide un recurso, por ejemplo GET /api/report.
2. El servidor responde 402 Payment Required. Una cabecera PAYMENT-REQUIRED lista las opciones de pago que acepta: esquema, red, token, importe y la dirección a la que pagar.
3. El cliente elige una opción y firma un pago con su billetera.
4. El cliente envía otra vez la misma petición, con el pago firmado en una cabecera PAYMENT-SIGNATURE.
5. El servidor verifica el pago, por su cuenta o llamando al endpoint /verify de un facilitador.
6. El servidor hace el trabajo y liquida el pago on-chain, por su cuenta o mediante el endpoint /settle del facilitador.
7. El servidor responde 200 OK con el recurso y una cabecera PAYMENT-RESPONSE que contiene el resultado de la liquidación.

Si el cliente ya conoce el precio, puede saltarse la primera ida y vuelta y pagar con su primera petición.

En la red se ve así. El valor de cada cabecera es JSON codificado en base64:

GET /api/report HTTP/1.1
Host: api.example.com

HTTP/1.1 402 Payment Required
PAYMENT-REQUIRED: <price, network, token and pay-to address>

GET /api/report HTTP/1.1
Host: api.example.com
PAYMENT-SIGNATURE: <the signed payment>

HTTP/1.1 200 OK
PAYMENT-RESPONSE: <settlement result>

Términos de x402: cliente, servidor, facilitador y esquema

Término	Qué significa
Cliente	La app, el script o el agente de IA que paga. Necesita una billetera con saldo de un token, normalmente USDC.
Servidor de recursos	La API o la web que cobra. Responde a las peticiones sin pago con un 402 y un precio.
Facilitador	Un servidor que verifica y ejecuta pagos en una o varias redes. Es opcional: el servidor de recursos puede verificar y liquidar los pagos por sí mismo.
Esquema	Cómo funciona el pago. El repositorio lista exact (un importe fijo, como 1 USD por leer un artículo), upto (el cliente autoriza un máximo y el vendedor liquida el uso real hasta ese límite) y batch-settlement (solo EVM: muchos cargos pequeños liquidados on-chain por lotes).

Qué cambió en x402 V2

El anuncio de V2 y la FAQ de Coinbase enumeran estos cambios:

• Cabeceras nuevas. PAYMENT-REQUIRED, PAYMENT-SIGNATURE y PAYMENT-RESPONSE sustituyen a X-PAYMENT y X-PAYMENT-RESPONSE de V1. Ahora todos los datos del pago viajan en cabeceras; V1 enviaba los requisitos de pago en el cuerpo de la respuesta.
• Nombres de red estándar. Las redes usan identificadores CAIP-2. Base es eip155:8453, y una red de Solana es solana: seguido de su genesis hash.
• Sesiones. V2 añade una identidad basada en la billetera, para no tener que volver a pagar en cada llamada.
• Extensiones y plugins. Las funciones nuevas llegan como extensiones, sin cambiar la especificación. Un ejemplo es Discovery, que permite a los servicios x402 publicar metadatos que los facilitadores pueden indexar. En los SDK, las cadenas, los tokens y los esquemas son plugins.
• Compatibilidad. Los SDK de referencia son totalmente compatibles con V1.

Qué redes y tokens admite x402

x402.org dice que el protocolo no depende de ninguna blockchain, que admite todas las cadenas compatibles con EVM, Solana y más, y que los pagos con stablecoins son el caso de uso principal. También está pensado para ampliarse a métodos de pago tradicionales.

Lo que funciona en la práctica depende del facilitador que uses. El facilitador alojado de Coinbase, por ejemplo, liquida en las mainnets de Base, Polygon, Arbitrum, Monad, World y Solana (FAQ). Acepta tokens ERC-20 en esas redes EVM y tokens SPL o Token-2022 en Solana. Los tokens que implementan EIP-3009, como USDC y EURC, se liquidan sin que el comprador tenga un token para pagar el gas. Los demás tokens ERC-20 pasan por Permit2, que puede añadir una aprobación única cuyo gas paga el comprador.

Cuánto cuesta x402

• Comisión del protocolo: ninguna. x402.org anuncia cero comisiones de protocolo: el uso es gratis para el cliente y para el comercio, que solo pagan las pequeñas comisiones de la red de pago.
• Comisión de red. Cada liquidación es una transacción en la blockchain, y alguien paga su gas. El facilitador de Coinbase lo paga y lo cubre con su precio por transacción.
• Comisión del facilitador. Cada facilitador fija la suya. El de Coinbase deja gratis las primeras 1.000 transacciones de cada mes y después cobra 0,001 USD por transacción. La verificación es gratis.

x402 frente a una pasarela de pago cripto

	x402	Pasarela de pago cripto
Quién paga	Software: un agente de IA, un script o una app con billetera	Personas, en una página de pago
Cuándo se paga	Dentro de la petición HTTP, en cada llamada	En el checkout, por pedido o por periodo de facturación
Precio	Por petición: un importe exacto o hasta un límite	Pedidos, facturas y suscripciones
Cómo paga el pagador	El cliente firma en código, sin página	La persona paga desde su billetera en una página alojada
Cómo se entera tu backend	La cabecera PAYMENT-RESPONSE de la misma petición	Webhooks y un panel
OrcaRail hoy	No disponible	Sí

Los dos resuelven problemas distintos. x402 encaja con APIs, datos y contenido que el software compra por su cuenta, petición a petición. Una pasarela de pago encaja con vender a personas: una página de producto, una factura o un plan mensual.

Para quién es x402

• Proveedores de APIs y datos que quieren cobrar por llamada sin cuentas ni claves de API.
• Creadores de agentes de IA cuyos agentes deben pagar por su cuenta herramientas, datos o contenido.
• Editores que quieren cobrar por artículo o por petición en lugar de con una suscripción.

Si tus clientes son personas que compran productos, planes o servicios, un checkout alojado sigue siendo el camino más sencillo. La gente espera una página de pago, un recibo y una forma de gestionar su suscripción.

Cómo empezar con x402

1. Lee la especificación en el repositorio de la x402 Foundation y elige un esquema. exact es el más sencillo.
2. Instala un SDK. El README lista paquetes de TypeScript bajo @x402/, un paquete de Python (pip install x402) y un módulo de Go.
3. Prueba primero en una testnet, por ejemplo Base Sepolia (eip155:84532). Nuestra guía de faucets de testnet indica dónde conseguir USDC de prueba gratis.
4. Elige un facilitador, o verifica y liquida los pagos en tu propio servidor.
5. Pasa a mainnet cuando los pagos de prueba se liquiden como esperas, con una billetera que controles como dirección de cobro.

Qué ofrece OrcaRail en su lugar

OrcaRail no admite x402 hoy. Es una pasarela de pago cripto para vender a personas. Tus clientes pagan en un checkout alojado (payment intents), con un enlace de pago o con una suscripción, en USDC, USDT u otros tokens en redes EVM, Solana y Bitcoin. Cada pago se reenvía a tus propias billeteras. OrcaRail cobra un 0,5 % por transacción completada, y las primeras 100 transacciones son gratis (precios).

Aun así, los agentes de IA pueden gestionar esos pagos por ti. El servidor MCP de OrcaRail permite que Claude Code, Cursor y Codex creen checkouts y suscripciones a partir de un prompt; pagos con agentes de IA explica cómo conectarlo en un sandbox. Para crear una integración con un agente de programación, dale llms.txt y consulta Construir con IA.

¿Quieres cobrar en USDC a tus clientes hoy? Consulta cómo aceptar pagos en USDC.

Preguntas frecuentes

¿Qué significa x402?

Debe su nombre al código de estado HTTP 402, Payment Required, que el estándar HTTP reserva para uso futuro. x402 es un protocolo, no una moneda: los pagos mueven tokens que ya existen, sobre todo stablecoins como USDC.

¿x402 es gratis?

El protocolo en sí no tiene comisiones. Sigues pagando las comisiones de red, y un facilitador puede cobrar por verificar y liquidar pagos. El facilitador de Coinbase, por ejemplo, deja gratis las primeras 1.000 transacciones de cada mes y después cobra 0,001 USD por transacción (revisado el 12 de noviembre de 2026).

¿x402 funciona en Solana?

Sí. x402.org incluye las cadenas EVM y Solana, y el facilitador de Coinbase liquida en la mainnet de Solana. En V2, una red de Solana se nombra solana: seguido de su genesis hash.

¿Dónde está el repositorio de x402 en GitHub?

En github.com/x402-foundation/x402, con licencia Apache-2.0. El antiguo repositorio coinbase/x402 es ahora un fork de desarrollo, y sus issues y pull requests pasaron al repositorio de la x402 Foundation.

¿OrcaRail admite x402?

Hoy no. OrcaRail ofrece checkouts alojados, enlaces de pago y suscripciones para personas que pagan en USDC, USDT y otros tokens, y un servidor MCP que permite a los agentes de IA crear esos pagos por ti.

---

Empieza en el sandbox · Pagos con agentes de IA · Precios