Saltar al contenido
UCP
Menú

WooCommerce · Guía Técnica

WooCommerce + UCP: guía completa de integración

WooCommerce impulsa aproximadamente el 30% de todas las tiendas online, lo que la convierte en la plataforma no-Shopify más importante para la adopción de UCP. A diferencia de Shopify, WooCommerce no tiene soporte UCP nativo incorporado. Pero su API REST extensible y su ecosistema de plugins activo hacen que la integración sea factible para la mayoría de los comerciantes sin un gran desarrollo personalizado.

Actualizado : Abril 2026 · Consulta principal : Implementación de UCP en WooCommerce

Opción 1: Plugin UCP (recomendado para la mayoría de los comerciantes)

El camino más sencillo para los comerciantes de WooCommerce es un plugin UCP dedicado. Varios se publicaron en el repositorio de plugins de WordPress en el primer trimestre de 2026. Estos plugins exponen automáticamente endpoints REST compatibles con UCP utilizando sus datos de productos, inventario y gestión de pedidos existentes de WooCommerce, sin necesidad de código personalizado.

Lo que un plugin UCP suele manejar: generación de endpoints de catálogo a partir del catálogo de productos de WooCommerce, sincronización de inventario desde la gestión de stock de WooCommerce, enrutamiento de pago a su pasarela de pago existente a través de un wrapper AP2 y creación de pedidos en el administrador de WooCommerce a partir de compras de agentes.

Antes de instalar, verifique el plugin: que tenga mantenimiento activo, que sea compatible con su versión de WooCommerce, que admita el flujo de pago AP2 para su procesador de pagos y, idealmente, que tenga pruebas de certificación UCP integradas.

Opción 2: Implementación personalizada de la API REST

Los comerciantes con recursos de desarrollo que deseen un control total pueden construir endpoints UCP directamente utilizando la API REST de WooCommerce como backend. WooCommerce expone su propia API REST en /wp-json/wc/v3/, su capa UCP traduce entre el formato de la API de WooCommerce y la especificación UCP.

Endpoint de catálogo

Su endpoint GET /ucp/v1/catalog debe consultar la API de productos de WooCommerce y transformar la respuesta al formato UCP. El mapeo de campos clave:

  • WooCommerce id → UCP id
  • WooCommerce name → UCP name
  • WooCommerce description (sin HTML) → UCP description
  • WooCommerce regular_price → UCP price
  • WooCommerce currency → UCP currency
  • WooCommerce stock_status (instock/outofstock) → UCP availability (InStock/OutOfStock)
  • WooCommerce categories[0].name → UCP category (mapeado a la taxonomía UCP)

Ejemplo de registro de endpoint PHP

add_action('rest_api_init', function() {
  register_rest_route('ucp/v1', '/catalog', array(
    'methods'  => 'GET',
    'callback' => 'ucp_get_catalog',
    'permission_callback' => 'ucp_verify_agent_cert',
  ));
});

function ucp_get_catalog($request) {
  $wc_products = wc_get_products(array(
    'status' => 'publish',
    'limit'  => $request->get_param('limit') ?: 50,
    'page'   => $request->get_param('page') ?: 1,
  ));
  $ucp_products = array_map('map_wc_to_ucp', $wc_products);
  return rest_ensure_response(array(
    'products' => $ucp_products,
    'total'    => wp_count_posts('product')->publish,
  ));
}

Integración de pagos: conectando AP2

La capa de pago requiere que su pasarela de pago de WooCommerce admita el procesamiento de tokens AP2. Para Stripe (el procesador de pagos de WooCommerce más común): instale la extensión Stripe AP2 para WooCommerce (disponible a través de la biblioteca de plugins de Stripe), configure su token de comerciante AP2 en el Panel de Stripe → Comercio Agentivo y actualice su endpoint de pago UCP para pasar los tokens AP2 a la API de intención de pago AP2 de Stripe.

Para otros procesadores (Adyen, PayPal, Square): contacte a su procesador para obtener su guía de integración de WooCommerce + AP2. Todos los procesadores de pago de la coalición UCP han publicado documentación de integración de WooCommerce.

Sincronización de inventario: manteniendo los datos actualizados

Un problema común con las implementaciones de UCP en WooCommerce son los datos de inventario obsoletos. WooCommerce no envía de forma nativa los cambios de stock a las API externas, sus endpoints UCP deben extraer el stock actual en cada solicitud. Para tiendas de alto tráfico, agregue una capa de caché (Redis o la API de Transients de WordPress) con un TTL máximo de 15 minutos. Para tiendas de menor tráfico, consulte el stock de WooCommerce directamente en cada solicitud UCP, la sobrecarga suele ser aceptable.

Probando su implementación

Antes de registrar su endpoint, valide con estos pasos:

  1. Pruebe el endpoint de catálogo: curl -H "Authorization: Bearer [test-token]" https://yourstore.com/ucp/v1/catalog, verifique que la respuesta coincida con el esquema UCP
  2. Pruebe el endpoint de disponibilidad para un ID de producto específico, verifique el reflejo del stock en tiempo real
  3. Realice una compra de prueba con el modo sandbox de UCP, verifique que el pedido aparezca en el administrador de WooCommerce
  4. Ejecute la suite de pruebas oficial de UCP (ucp.dev/testing) en su sitio de staging
  5. Verifique los tiempos de respuesta, todos los endpoints deben responder en 3 segundos

Registrando su tienda WooCommerce

Una vez probado, registre su endpoint UCP en ucp.dev/merchant-registry. Necesitará: la URL de su tienda, la URL base de su endpoint UCP, su token de comerciante AP2 y los resultados de sus pruebas de certificación UCP. Después del registro, envíe la URL de su endpoint a Google Merchant Center en la configuración de Comercio Agentivo para habilitar el descubrimiento de Gemini.

Lectura adicional