Zum Inhalt springen
UCP
Menü

WooCommerce · Technische Anleitung

WooCommerce + UCP: Komplette Integrationsanleitung

WooCommerce betreibt etwa 30 % aller Online-Shops und ist damit die wichtigste Nicht-Shopify-Plattform für die UCP-Einführung. Im Gegensatz zu Shopify verfügt WooCommerce nicht über eine native UCP-Unterstützung. Aber seine erweiterbare REST-API und sein aktives Plugin-Ökosystem machen die Integration für die meisten Händler ohne umfangreiche kundenspezifische Entwicklung erreichbar.

Aktualisiert : April 2026 · Hauptsuchanfrage : WooCommerce UCP-Implementierung

Option 1: UCP-Plugin (für die meisten Händler empfohlen)

Der einfachste Weg für WooCommerce-Händler ist ein spezielles UCP-Plugin. Mehrere wurden im ersten Quartal 2026 im WordPress-Plugin-Repository veröffentlicht. Diese Plugins stellen automatisch UCP-konforme REST-Endpunkte bereit, die Ihre vorhandenen WooCommerce-Produktdaten, Ihr Inventar und Ihre Auftragsverwaltung nutzen, ohne dass benutzerdefinierter Code erforderlich ist.

Was ein UCP-Plugin typischerweise handhabt: Generierung des Katalog-Endpunkts aus dem WooCommerce-Produktkatalog, Inventarsynchronisierung aus der WooCommerce-Lagerverwaltung, Weiterleitung des Checkouts an Ihr vorhandenes Zahlungsgateway über den AP2-Wrapper und Auftragserstellung im WooCommerce-Admin aus Agentenkäufen.

Überprüfen Sie vor der Installation des Plugins: ob es aktiv gewartet wird, mit Ihrer WooCommerce-Version kompatibel ist, den AP2-Zahlungsfluss für Ihren Zahlungsabwickler unterstützt und idealerweise UCP-Zertifizierungstests integriert hat.

Option 2: Benutzerdefinierte REST-API-Implementierung

Händler mit Entwicklerressourcen, die die volle Kontrolle wünschen, können UCP-Endpunkte direkt über die WooCommerce REST-API als Backend erstellen. WooCommerce stellt seine eigene REST-API unter /wp-json/wc/v3/ bereit, Ihre UCP-Schicht übersetzt zwischen dem WooCommerce-API-Format und der UCP-Spezifikation.

Katalog-Endpunkt

Ihr GET /ucp/v1/catalog-Endpunkt sollte die WooCommerce-Produkte-API abfragen und die Antwort in das UCP-Format umwandeln. Die wichtigsten Feldzuordnungen:

  • WooCommerce id → UCP id
  • WooCommerce name → UCP name
  • WooCommerce description (ohne 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 (auf UCP-Taxonomie abgebildet)

Beispiel für PHP-Endpunktregistrierung

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,
  ));
}

Zahlungsintegration: AP2 verbinden

Die Zahlungsebene erfordert, dass Ihr WooCommerce-Zahlungsgateway die AP2-Token-Verarbeitung unterstützt. Für Stripe (den gängigsten WooCommerce-Zahlungsabwickler): Installieren Sie die Stripe AP2-Erweiterung für WooCommerce (verfügbar über die Plugin-Bibliothek von Stripe), konfigurieren Sie Ihr AP2-Händler-Token im Stripe Dashboard → Agentic Commerce und aktualisieren Sie Ihren UCP-Checkout-Endpunkt, um AP2-Token an die AP2-Zahlungsabsichts-API von Stripe zu übergeben.

Für andere Abwickler (Adyen, PayPal, Square): Kontaktieren Sie Ihren Abwickler für deren WooCommerce + AP2-Integrationsanleitung. Alle UCP-Koalitions-Zahlungsabwickler haben WooCommerce-Integrationsdokumentationen veröffentlicht.

Inventarsynchronisierung: Daten aktuell halten

Ein häufiges Problem bei WooCommerce UCP-Implementierungen sind veraltete Bestandsdaten. WooCommerce überträgt Bestandsänderungen nicht nativ an externe APIs, Ihre UCP-Endpunkte müssen bei jeder Anfrage den aktuellen Bestand abrufen. Für stark frequentierte Geschäfte fügen Sie eine Caching-Schicht (Redis oder WordPress Transients API) mit einer maximalen TTL von 15 Minuten hinzu. Für weniger frequentierte Geschäfte fragen Sie den WooCommerce-Bestand direkt bei jeder UCP-Anfrage ab, der Overhead ist typischerweise akzeptabel.

Testen Ihrer Implementierung

Bevor Sie Ihren Endpunkt registrieren, validieren Sie ihn mit diesen Schritten:

  1. Katalog-Endpunkt testen: curl -H "Authorization: Bearer [test-token]" https://yourstore.com/ucp/v1/catalog, überprüfen Sie, ob die Antwort dem UCP-Schema entspricht
  2. Verfügbarkeits-Endpunkt für eine bestimmte Produkt-ID testen, überprüfen Sie die Echtzeit-Bestandsanzeige
  3. Führen Sie einen Test-Checkout im UCP-Sandbox-Modus durch, überprüfen Sie, ob die Bestellung im WooCommerce-Admin erscheint
  4. Führen Sie die offizielle UCP-Testsuite (ucp.dev/testing) auf Ihrer Staging-Site aus
  5. Überprüfen Sie die Antwortzeiten, alle Endpunkte sollten innerhalb von 3 Sekunden antworten

Registrierung Ihres WooCommerce-Shops

Nach dem Testen registrieren Sie Ihren UCP-Endpunkt unter ucp.dev/merchant-registry. Sie benötigen: Ihre Shop-URL, Ihre UCP-Endpunkt-Basis-URL, Ihr AP2-Händler-Token und Ihre UCP-Zertifizierungstestergebnisse. Nach der Registrierung übermitteln Sie Ihre Endpunkt-URL an das Google Merchant Center unter den Agentic Commerce-Einstellungen, um die Gemini-Erkennung zu ermöglichen.

Weiterführende Literatur