Qué es UCP y cómo comprobarlo
Última actualización:
UCP — el Protocolo Universal de Comercio (Universal Commerce Protocol) — es el estándar abierto que permite a un asistente de IA comprar en nombre de una tienda. Una tienda publica un pequeño perfil legible por máquina en /.well-known/ucp, y cualquier asistente que hable el protocolo puede leerlo para saber qué versión habla la tienda, cómo llegar a su catálogo y a su checkout, y qué procesadores de pago acepta — sin una integración a medida por tienda, sin raspar pantallas, sin adivinar. Es el mismo problema que llms.txt resuelve para el contenido, aplicado al comercio: un humano lee un escaparate, pero un agente necesita un manifiesto. Puedes pegar cualquier tienda en el Comprobador de UCP y leer su perfil como un veredicto — accesible, bien formado, actual, o no es UCP en absoluto — pero este artículo te enseña a leer el documento tú mismo, para que la próxima vez que un perfil falle, puedas ver por qué en el texto.
Qué es UCP, y por qué lo necesitan los asistentes de IA
UCP es un estándar abierto de Google, codesarrollado con Shopify, que da a los asistentes de IA un lenguaje común para comprar: descubrir una tienda, buscar en su catálogo, armar un carrito, pagar, y seguir el pedido después. El asistente habla con la tienda a través del protocolo en lugar de a través de una integración a medida, y el comerciante sigue siendo el comerciante registrado — conservando sus datos de clientes y sus relaciones, como dice la propia guía de Google. El sentido del estándar es colapsar un problema de integración N por N: sin él, cada asistente necesitaría un acuerdo distinto con cada comerciante; con él, cada lado implementa una vez e interoperan.
La necesidad es nueva porque la superficie de compra es nueva. Los asistentes ya se encuentran con los compradores dentro de AI Mode en la Búsqueda de Google y en la app de Gemini, donde una pregunta puede convertirse en una compra sin abrir jamás la pestaña de una tienda. Una ventana de chat no puede pulsar "añadir al carrito", así que el asistente necesita una forma de preguntarle a la tienda, en términos de máquina, qué vende, cómo se compra, y qué ocurre después de la venta. UCP es esa forma: cubre todo el recorrido, del descubrimiento al checkout y a la posventa — pedidos, fulfillment, descuentos — y está diseñado para interoperar con los estándares vecinos de transporte (MCP, A2A) y de prueba de pago (AP2), en lugar de sustituirlos.
El archivo de descubrimiento: /.well-known/ucp y sus tres campos obligatorios
Todo el protocolo empieza con un archivo. Una empresa publica su perfil — un objeto JSON con un miembro ucp obligatorio — en /.well-known/ucp, y una plataforma lo descarga antes de hacer nada más. Dentro de ucp, tres campos son obligatorios: version, la versión del protocolo como fecha; services, las superficies de API que ofrece la empresa, identificadas por nombre de dominio inverso como dev.ucp.shopping, cada entrada emparejando el servicio con una vinculación de transporte (REST, MCP, A2A o embedded) y un endpoint; y payment_handlers, los métodos de pago que acepta. Los dos últimos deben estar presentes aunque estén vacíos — un objeto vacío es una afirmación válida ("aún no ofrecemos servicios"), un campo ausente es un perfil roto. Un cuarto miembro, capabilities, es opcional pero es lo que hace útil a un perfil: enumera las funciones individuales — checkout, carrito, pedido, búsqueda de catálogo — cada una con su propia versión, spec y URLs de esquema.
El archivo también tiene reglas de alojamiento, y son estrictas por una razón. Los perfiles publicados deben servirse por HTTPS, no deben redirigir, y deben llevar Cache-Control: public con un max-age de al menos 60 segundos — nunca private, no-store ni no-cache. Un perfil es la identidad estable y la lista de capacidades de una tienda, no una respuesta por transacción, así que está pensado para cachearse y descargarse barato; una redirección o una directiva no-cache le dice a una plataforma que el editor no ha configurado el documento como el manifiesto estable que el protocolo espera. Las plataformas anuncian su propio perfil en la otra dirección, en la cabecera de petición UCP-Agent, que es lo que hace posible la incorporación sin permiso: cualquier plataforma con un perfil descubrible puede hablar con cualquier empresa que tenga uno, sin registro previo.
Leer un documento real a mano: Allbirds
Las tiendas de Shopify publican un perfil UCP por defecto, así que cualquiera de ellas es un ejemplo en vivo — tomemos Allbirds, descargado el 21 de noviembre de 2026. Su ucp.version es "2026-08-25", la versión actual, y un objeto supported_versions asigna dos versiones anteriores — 2026-04-08 y 2026-01-23 — a URLs de perfil versionadas en su dominio myshopify.com, para que los clientes antiguos aún puedan negociar. En services, dev.ucp.shopping aparece dos veces: una con transporte mcp en /api/ucp/mcp y otra con transporte embedded — y fíjate en lo que falta: no hay entrada rest. Una tienda no tiene que ofrecer todos los transportes; anuncia los que realmente ejecuta. Un segundo servicio, dev.ucp.common, también se ofrece por MCP.
El objeto capabilities es donde el documento se vuelve específico. Allbirds anuncia dev.ucp.shopping.checkout, cart, order, catalog.search y catalog.lookup, además de extensiones: fulfillment y discount, que declaran extender checkout y cart, y buyer_consent, identity_linking y una capacidad permalink. Los nombres son de dominio inverso por diseño: los nombres dev.ucp.* los gobierna el organismo de UCP, mientras que las entradas dev.shopify.* — aquí dev.shopify.catalog y la extensión dev.shopify.shopping.declared_fields — son de Shopify. En payment_handlers hay tres procesadores: com.google.pay, dev.shopify.card y dev.shopify.shop_pay, cada uno con su versión, spec y esquema. Falta una cosa, y su ausencia está bien: el documento no lleva un array keys de nivel superior. Las claves de firma son opcionales — un perfil solo las publica cuando la tienda firma peticiones — así que un perfil sin claves no es un perfil roto.
Las versiones son fechas, y la 2026-08-25 rompió cosas
Las versiones de UCP son fechas de calendario en formato YYYY-MM-DD, y la especificación es tajante: una empresa no debe anunciar una cadena de versión que no sea una fecha, como "draft", en su perfil. La versión actual es 2026-08-25; las anteriores sobreviven a través de supported_versions, cada una apuntando a un perfil hoja completo y autocontenido para esa fecha. La compatibilidad se establece por igualdad exacta de versión, no por "más nuevo es mejor": una plataforma y una empresa cruzan las versiones que ambas soportan, y si no hay versión compartida la empresa debe responder version_unsupported. Hay una trampa más que conviene conocer: cada entrada dev.ucp.* de servicio, capacidad y extensión en un perfil debe declarar la misma versión que el ucp.version del perfil, y una plataforma que se encuentre una entrada con versión distinta debe rechazarla de plano, tratándola como ausente.
Por eso una versión antigua recibe una advertencia y no un aprobado. La versión 2026-08-25 fue el mayor cambio estructural del protocolo: eliminó el antiguo campo signing_keys[] del esquema del perfil e hizo del array keys[] de nivel superior — un JWK Set — el único lugar canónico para las claves de firma, así que un cliente construido para la nueva versión que lea signing_keys no encontrará nada; trasladó las extensiones de pago del espacio de nombres dev.ucp.shopping.* a dev.ucp.common.payment.*; reestructuró el consentimiento del comprador, de banderas booleanas fijas a un mapa dinámico; y consolidó la configuración de fulfillment. Una tienda que sigue en 2026-04-08 continúa funcionando para los clientes que hablan 2026-04-08, que es exactamente para lo que existe supported_versions — pero un asistente que solo hable la nueva versión no encontrará versión mutuamente soportada, y cualquier herramienta que dependa de los nombres o campos antiguos fallará en silencio. Viejo, en UCP, significa "congelado en el tiempo", no "roto" — y la advertencia es la diferencia.
UCP frente a ACP, AP2 y x402
ACP — el Protocolo de Comercio Agéntico (Agentic Commerce Protocol), codesarrollado por OpenAI y Stripe — cubre el paso del checkout dentro de una superficie de chat como ChatGPT: el comprador aprueba la compra en la conversación, y la empresa cobra a través de su propio proveedor de pagos. Tiene alcance de checkout, no de recorrido completo de compra: responde cómo paga el comprador en el chat, y deja el descubrimiento del catálogo y la posventa a otra cosa. Piensa en él como el paralelo de UCP en las superficies de OpenAI, donde UCP es el equivalente en las de Google.
AP2 — el Protocolo de Pagos de Agentes (Agent Payments Protocol), publicado por Google — responde a otra pregunta: no cómo funciona el checkout, sino qué autorizó realmente el usuario. Produce mandatos firmados y verificables — un mandato de checkout para la compra en sí y un mandato de pago para el lado del pago — para que un comerciante, una red y un emisor puedan comprobar la misma prueba en lugar de fiarse de la palabra del agente. Está diseñado para funcionar junto a UCP, aportando la autorización firmada dentro de un flujo UCP, no para competir con él.
x402 — creado por Coinbase — responde a una tercera pregunta: ¿cómo paga un agente por una sola cosa, una vez, sin cuenta y sin página de checkout? Recupera el código de estado HTTP dormido 402 Payment Required: el agente pide un recurso de pago, el servidor responde 402 con un precio, y el agente reintenta con un pago firmado, normalmente en stablecoins liquidadas en cadena. Es un contador de pago por llamada para APIs, datos y contenido — la herramienta adecuada cuando la compra es una sola petición, y la forma equivocada para un carrito de la compra.
Los cuatro son complementos, no rivales, y la mayoría de los sistemas reales los combinan: UCP ejecuta el recorrido de compra, AP2 puede aportar la prueba firmada dentro de él, x402 tarifa las llamadas individuales por el camino, y ACP es la ruta de checkout en las superficies de OpenAI. Esa es también la frontera del comprobador de este sitio: el Comprobador de UCP solo lee perfiles UCP. No descarga ni valida documentos ACP, AP2 ni x402, así que una tienda puede estar lista para UCP y no tener ninguna presencia ACP o AP2 — los protocolos son independientes, y que falte uno no es un fallo del otro.
Qué hace el comprobador de UCP, y qué no hace
El comprobador descarga https://<objetivo>/.well-known/ucp a través del servicio de comprobación en el servidor — tu navegador nunca descarga el objetivo directamente, porque las reglas de origen cruzado bloquearían la mayoría de las tiendas — y luego recorre el perfil como lo hace la especificación. Comprueba que el documento sea accesible por HTTPS sin redirección (una redirección es un fallo, según la especificación), lee la cabecera Cache-Control y cita su valor real, analiza el JSON e informa del error exacto de análisis si falla, y verifica que los tres campos obligatorios estén presentes, que la versión sea una fecha, y que la versión no sea anterior a 2026-08-25. Enumera cada servicio con su transporte y versión, cada procesador de pago, y cada capacidad con el servicio al que pertenece, y sondea cada endpoint declarado para ver si es accesible. El veredicto es uno de tres: listo para UCP, parcial, o no-UCP — un 404 en el perfil es el negativo habitual, y el comprobador lo dice explícitamente.
Lo que no hace importa igual de mucho. No realiza pedidos, no se autentica como comprador, y no valida la criptografía de los procesadores de pago — la presencia de un array keys[] prueba procedencia (las claves pertenecen al dominio que las publicó), no confianza, y la especificación lo dice con esas mismas palabras. No comprueba documentos ACP, AP2 ni x402. Y un resultado limpio no es una promesa de que el checkout vaya a funcionar: el perfil es publicidad, no una transacción, y el endpoint que hay detrás puede seguir exigiendo autenticación, una cuenta de comprador o aprobación del comerciante antes de hacer nada. Un comprobación limpia significa que la tienda se describe correctamente y puede descubrirse; que la compra se complete es cosa de los propios sistemas de la tienda. Para el panorama más amplio — si un sitio está listo para los agentes en general, archivo de descubrimiento incluido — el Comprobador de preparación para agentes revisa el archivo UCP entre sus otras señales.
Pruébalo tú mismo: un perfil UCP mínimo, anotado por su propia forma
{
"ucp": {
"version": "2026-08-25",
"services": {
"dev.ucp.shopping": [
{
"version": "2026-08-25",
"transport": "rest",
"endpoint": "https://business.example.com/ucp/v1",
"spec": "https://ucp.dev/2026-08-25/specification/overview/",
"schema": "https://ucp.dev/2026-08-25/services/shopping/rest.openapi.json"
},
{
"version": "2026-08-25",
"transport": "mcp",
"endpoint": "https://business.example.com/ucp/mcp",
"spec": "https://ucp.dev/2026-08-25/specification/overview/",
"schema": "https://ucp.dev/2026-08-25/services/shopping/mcp.openrpc.json"
}
]
},
"capabilities": {
"dev.ucp.shopping.checkout": [
{
"version": "2026-08-25",
"spec": "https://ucp.dev/2026-08-25/specification/shopping/checkout",
"schema": "https://ucp.dev/2026-08-25/schemas/shopping/checkout.json"
}
]
},
"payment_handlers": {
"com.example.processor_tokenizer": [
{
"id": "processor_tokenizer",
"version": "2026-08-25",
"spec": "https://example.com/specs/payments/processor_tokenizer",
"schema": "https://example.com/specs/payments/merchant_tokenizer.json"
}
]
}
}
}