Cómo configurar el Universal Commerce Protocol en su tienda.Google tiene que aprobar la integración antes de que un comprador pueda comprarle en AI Mode o Gemini.

Un comprador pide un producto en AI Mode de Google, el agente lo encuentra en su catálogo y la compra se realiza sin que el comprador llegue a cargar su sitio. El Universal Commerce Protocol (UCP) es lo que permite al agente hacerlo, y solo funciona cuando su tienda responde correctamente en el momento en que el agente pregunta. ¿Qué tiene que publicar su tienda? ¿Qué productos puede comprar un agente? ¿Qué comprueba Google antes de dejarle activar la integración? En el trabajo de UCP que hemos hecho, la página de producto ha sabido más que el feed en todos los casos, y un endpoint construido solo a partir del feed daría a los agentes menos información de la que un comprador ve en la página.

UCP es un estándar abierto, y su tienda publica lo que admite

UCP fue desarrollado por Google junto con Shopify, Etsy, Wayfair, Target y Walmart, y su especificación está en ucp.dev. Su tienda es el comerciante registrado (merchant of record): usted conserva el cliente, el pedido y la responsabilidad del pago, y el agente actúa en nombre del comprador.

Todo empieza con un perfil que su tienda publica en /.well-known/ucp. Indica la versión del protocolo, los servicios que ofrece y cómo acceder a ellos, sus gestores de pagos y las claves públicas que un agente usa para verificar sus mensajes firmados. Un agente lo lee antes de hacer cualquier otra cosa.

Las versiones de UCP son fechas. La especificación más reciente a octubre de 2026 es 2026-08-25, y las guías de implementación de Google usan 2026-04-08. Una tienda puede ofrecer REST, MCP, A2A o un checkout integrado, y REST es la principal.

Paso 1: Corrija los datos de producto erróneos

Google lee un feed según una programación, pero un agente llama a un endpoint de UCP en tiempo real, así que cualquier error en sus datos llega al comprador en el momento de la compra, sin nadie que lo detecte. Corregimos los datos erróneos antes de añadir nada, y estas correcciones dan resultado en Merchant Center tanto si UCP llega a lanzarse como si no.

Mantenga los GTIN como texto de principio a fin. Un sistema que los trata como números elimina los ceros iniciales, y el GTIN deja de coincidir. Compruebe cada uno con el registro GS1 del fabricante en lugar de rellenarlo hasta que encaje.

Paso 2: Añada los datos que un agente necesita para completar una compra

Las páginas de producto suelen contener más que el feed: la galería completa de imágenes, la marca, las valoraciones, el precio de lista real y las condiciones de entrega. Un agente solo ve lo que usted le envía.

• Descripciones extensas. Ponga primero la principal diferencia del producto, porque un agente puede citar solo el comienzo. Indique las limitaciones con claridad, como los límites de peso, los requisitos eléctricos y adónde se puede enviar, y dé las medidas en ambos sistemas de unidades.
• Variantes separadas. Un producto principal con tallas o colores agrupados en una sola fila tiene que convertirse en una fila por variante, agrupadas con item_group_id.
• Envío, devoluciones y garantía como datos, no solo como párrafos en una página de políticas.
• Todas las imágenes que muestra la página. Un feed que solo lleva la primera deja al agente con menos de lo que ve el comprador.
• Niveles de stock en vivo en lugar de un indicador de disponible o agotado. Google exige una comprobación de inventario en vivo en el checkout, y un error out_of_stock cuando el artículo se ha agotado.

Merchant Center limita una descripción a 5,000 caracteres y no quiere en ella detalles promocionales como precios u ofertas de envío, mientras que una descripción de UCP puede incluir entrega, garantía y limitaciones. Escriba la versión completa para UCP y recórtela para el feed.

Los precios en UCP son números enteros en la unidad más pequeña de la moneda, así que $129.99 se envía como 12999. Equivocarse de unidad pone al producto un precio cien veces erróneo, en un sentido o en el otro, así que compruébelo antes de que nada se active.

Paso 3: Decida qué productos puede comprar un agente

La guía de Merchant Center de Google excluye categorías enteras del checkout de agentes, entre ellas:

• suscripciones y planes a plazos o de financiación;
• productos personalizados, artículos reacondicionados, usados y de venta final, y preventas;
• servicios incluidos como la instalación o las garantías ampliadas, el transporte de carga y la entrega premium, y la activación en tienda;
• productos con restricción de edad y prohibidos, servicios, alquileres y artículos virtuales.

Deje esos fuera y active el resto producto por producto.

Un producto de precio alto que muchos compradores adquieren con un plan de financiación puede venderse peor a través de un checkout con monedero digital que no ofrece ese plan. Mida cuántos pedidos de ese producto usan financiación antes de activar el checkout de agentes para él. Una tienda también puede publicar su catálogo para los agentes y mantener el checkout en su propio sitio, lo que es una configuración legítima de UCP y a menudo la primera fase adecuada.

Paso 4: Prepare Merchant Center

La guía de implementación de Google empieza por Merchant Center: la cuenta tiene que estar en regla, con productos aprobados para fichas gratuitas.

• Política de devoluciones. Configure el coste de devolución, el plazo de devolución y un enlace a la política completa, a nivel de cuenta o por producto con el atributo returns. Google la muestra en la pantalla del checkout.
• Atención al cliente. Añada al menos un método de contacto: una página de soporte, una dirección de correo electrónico o un número de teléfono. Alimenta el enlace “Contact Merchant” de la confirmación del pedido.
• Active los productos. Establezca native_commerce(checkout_eligibility) en TRUE para cada producto apto. Google recomienda una fuente de datos complementaria, para que la activación no altere su feed principal.
• Avisos regulatorios. Los productos que llevan un aviso legal, una advertencia de seguridad o una advertencia de la Proposition 65 necesitan un consumer_notice, con su tipo y un mensaje de hasta 1,000 caracteres.
• IDs coincidentes. El id del feed tiene que coincidir con el ID de producto que espera su checkout. Cuando no coincidan, envíe merchant_item_id.

Paso 5: Inscríbase en la lista de espera de Google

Google dice que una integración “debe ser aprobada por Google antes de que pueda activarse” en AI Mode y Gemini. La vía de entrada es el formulario de interés para la integración de UCP en la Ayuda de Merchant Center, que pone su tienda en la lista de espera. El checkout integrado, en el que su propio checkout se ejecuta dentro de la interfaz de Google, está limitado a comerciantes aprobados. Envíe el formulario mientras construye, ya que la aprobación es el paso que usted no puede acelerar.

Paso 6: Construya el perfil y los endpoints

Una tienda o bien usa la compatibilidad con UCP integrada en su plataforma de comercio, o bien la construye. Cuando construimos, colocamos un servicio ligero delante de la tienda que habla UCP con los agentes y la API propia de la plataforma con la tienda, montado bajo el dominio de la tienda para que el perfil y los endpoints compartan un mismo origen. UCP se revisa con frecuencia, y mantenerlo fuera de la plataforma significa que una nueva versión no depende de una actualización de la plataforma.

• Publique solo lo que funciona. Un agente que encuentra el checkout en su perfil intentará usarlo. Una primera versión puede anunciar solo la búsqueda y la consulta en el catálogo, y añadir el checkout cuando esté listo.
• Use claves de firma reales. Las claves públicas del perfil verifican sus actualizaciones de pedido firmadas, así que genere un par de claves y mantenga la mitad privada en el servidor.
• Haga que los reintentos sean seguros. Acepte una clave de idempotencia en las llamadas de checkout, para que una solicitud repetida no cobre dos veces.
• Sírvalo sobre HTTPS. La especificación REST exige como mínimo TLS 1.3.
• Valide las direcciones. Devuelva una dirección a la que no se puede entregar como un error recuperable, para que el comprador pueda corregirla en lugar de llegar a un callejón sin salida.
• Enlace sus políticas. Sus condiciones se aplican a cada compra por UCP, así que incluya en la respuesta del checkout enlaces a sus políticas de privacidad, condiciones, reembolsos y envíos.

Paso 7: Conecte los pagos

En la vía de checkout nativo de Google, su perfil declara el gestor de pagos de Google Pay. No necesita la API de Google Pay en su propio sitio, pero su procesador de pagos debe aceptar los tokens de pago de Google, y la mayoría de los grandes procesadores lo hacen. Las preguntas frecuentes de Google señalan que sus interfaces de IA solo usan el método de autorización PAN_ONLY y que la configuración de Google Pay en el perfil usa nombres en snake_case. Mantenga separadas las credenciales de prueba y de producción del procesador, y no las registre nunca en los logs.

Paso 8: Pruebe como lo hará Google

Google envía comprobaciones de estado con el user agent Google-UCP-Prober/1.0, y marca las solicitudes de agentes con una cabecera UCP-Agent y un user agent que empieza por Google/UCP. Antes de presentar la solicitud, llame a sus propios endpoints como lo haría Google.

• ¿Llega /.well-known/ucp a su tienda? Una regla del servidor web puede responder a esa ruta con su propio 404 antes de que la solicitud llegue a la aplicación, incluso mientras sus endpoints de UCP funcionan.
• ¿Deja pasar su firewall a Google? Una protección contra bots que bloquea el tráfico automatizado también bloqueará al prober, así que deje pasar las solicitudes UCP de Google por sus cabeceras y no por su dirección.
• ¿Se comportan bien los endpoints protegidos? Los endpoints de checkout, pago y pedidos deben rechazar las solicitudes sin credenciales y aceptar las de Google.

Paso 9: Planifique la próxima versión de UCP

La especificación 2026-08-25 añade políticas estándar de devolución y garantía que 2026-04-08 no tiene, y Google documenta 2026-04-08. Hasta que las guías de Google adopten una versión más reciente, su política de devoluciones de Merchant Center lleva esa información. Cuando adopte una nueva versión, Google recomienda servirla desde un endpoint separado, para poder devolver el tráfico al anterior si algo falla.

WISLR configura UCP para marcas y para los clientes de agencias

Cada paso anterior forma parte del servicio Agentic Commerce Optimization de WISLR. Auditamos el catálogo frente a los requisitos de Google, corregimos y completamos los datos de producto, preparamos Merchant Center y el feed de activación, y construimos y probamos el perfil UCP y los endpoints hasta que la integración está lista para la aprobación de Google. Las marcas nos contratan directamente, y las agencias nos contratan bajo su propio nombre para configurarlo para sus clientes. Vea cómo configuramos UCP y solicite una evaluación de su catálogo.