Saltar al contenido
UCP
Menú

Guía Técnica · Implementación

Implementando UCP: guía completa para comerciantes y desarrolladores

¿Quieres que tu tienda sea compatible con el Universal Commerce Protocol para ser accesible a los agentes de IA? Esta guía técnica cubre los requisitos previos, los endpoints a exponer, la integración de pagos AP2, las pruebas de validación y los errores comunes a evitar.

Equipo editorial · Actualizado : Abril de 2026 · Consulta principal : implementar UCP

Integrar UCP según la especificación actual

El esfuerzo depende de los sistemas existentes de catálogo, checkout, identidad, pagos y pedidos. La especificación UCP no publica un plazo universal ni garantiza la compatibilidad de un procesador concreto.

1. Publicar el perfil

Publique el perfil del negocio en /.well-known/ucp mediante HTTPS y sin redirecciones. Declare la versión, las capacidades, los transportes, los esquemas y los endpoints base admitidos. El cliente y el negocio negocian versión y capacidades en cada interacción.

2. Construir las operaciones REST desde el perfil

  • POST /catalog/search busca productos.
  • POST /catalog/lookup resuelve identificadores de productos o variantes.
  • POST /checkout-sessions crea una sesión de checkout.
  • GET /orders/{id} devuelve el estado actual del pedido.

Las rutas son relativas al endpoint base anunciado. Precio y disponibilidad deben validarse de nuevo durante el checkout.

3. Limitar identidad y pagos

Identity Linking usa OAuth 2.0 y scopes. AP2 es una extensión opcional del checkout basada en Checkout Mandates y Payment Mandates firmados. Verifique la disponibilidad real en la documentación actual del proveedor de pagos.

4. Probar antes del lanzamiento

Valide el perfil, los encabezados de caché, la versión, la poda de capacidades, los esquemas JSON, la autenticación, las firmas HTTP y las respuestas de error. Mantenga pruebas de contrato e integración propias; no existe una suite central de certificación en la especificación.

Fuentes oficiales