Skip to content
← Guías para agentes

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.

AgenteServidorFacilitadorGET /recurso402 · monto + destinoGET + autorización de pagoverificar y liquidarpagado200 · recurso + recibo

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.

HumanoAgenteServidor MCPllama paidTool402 · USD 0.01¿confirmas el pago?síllama + pagoresultado

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.

AgenteServidor402 · scheme="deferred"compromiso firmado200 · Payment-Responseliquida en lote (diario, mensual)

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