Zum Inhalt springen
UCP
Menü

Technische Anleitung · Implementierung

UCP implementieren: vollständige Anleitung für Händler und Entwickler

Möchten Sie Ihren Shop mit dem Universal Commerce Protocol kompatibel machen, um für KI-Agenten zugänglich zu sein? Dieser technische Leitfaden behandelt Voraussetzungen, freizulegende Endpunkte, AP2-Zahlungsintegration, Validierungstests und häufige Fehler, die es zu vermeiden gilt.

Aktualisiert : April 2026 · Hauptsuchanfrage : UCP implementieren

Voraussetzungen, bevor Sie beginnen

Plattformkompatibilität

Wenn Sie Shopify verwenden: Sie haben einen Vorsprung. Shopify ist ein UCP-Mitbegründer und bietet seit der Einführung des Protokolls im Januar 2026 native Unterstützung. Der Schlüssel ist, die UCP-Funktionen in Ihrem Admin zu aktivieren und Ihre Produktdaten zu vervollständigen.

Für WooCommerce, Magento, PrestaShop, Salesforce Commerce oder BigCommerce: Die Spezifikationen sind auf dem offiziellen UCP GitHub offen. Ein Backend-Entwickler, der mit REST und JSON-RPC vertraut ist, kann eine grundlegende Integration in 2 bis 3 Arbeitstagen implementieren.

Für eine benutzerdefinierte Lösung: Eine direkte Implementierung ist möglich und unter ucp.dev dokumentiert. Planen Sie 5 bis 10 Entwicklungstage für eine vollständige Integration mit Tests ein.

Erforderliche Produktdatenqualität

  • Vollständig: Name, Beschreibung, Preis, Währung, Varianten (Größe, Farbe), Gewicht, Abmessungen
  • Identifiziert: GTIN/EAN oder proprietäre SKU pro Produkt dokumentiert
  • Aktuell: Lagerbestand nahezu in Echtzeit synchronisiert (maximale Verzögerung: wenige Minuten)
  • Angereichert: strukturierte Rückgaberichtlinien, Lieferzeiten nach Zone, kategoriespezifische Attribute

AP2-kompatibler Zahlungsabwickler

UCP basiert auf dem Agent Payments Protocol (AP2). Kompatible Abwickler sind Stripe, Adyen, Mastercard, Visa und American Express, alles UCP-Gründungspartner. Wenn Sie einen dieser Abwickler mit einer aktuellen Integration verwenden, erfordert die AP2-Unterstützung eine Aktivierung, keine technische Überarbeitung.

Schritt 1: Katalog-Endpunkte freilegen

UCP definiert standardisierte REST-Endpunkte, die Ihr Server für KI-Agenten freilegen muss, um Ihren Katalog abzufragen.

GET /ucp/v1/catalog

Gibt Ihre Produktliste im UCP JSON-LD-Format zurück. Jedes Produkt muss enthalten: @type: "Product", sku oder gtin, name, description, offers (mit Preis, Währung, Verfügbarkeit), shippingDetails und returnPolicy.

GET /ucp/v1/inventory/{sku}

Echtzeit-Verfügbarkeit eines bestimmten Produkts. Kritische Leistungsanforderungen: Antwort unter 200 ms, mindestens 99,5 % Verfügbarkeit. Ein Timeout schließt Ihr Produkt direkt aus, der KI-Agent wechselt zu einem Konkurrenten.

POST /ucp/v1/checkout

Empfängt Kaufanweisungen vom KI-Agenten und initiiert den Bestellvorgang. Muss Folgendes verarbeiten: Identitätsvalidierung (UCP Identity Linking), Lagerreservierung, AP2-Zahlungsinitiierung und Generierung einer Bestellbestätigung mit Sendungsverfolgungsnummer.

Schritt 2: Identity Linking implementieren

Identity Linking ermöglicht es einem KI-Agenten, die Identität eines Benutzers mit Ihrem Händlersystem zu verknüpfen, ohne dass sich der Benutzer bei jedem Kauf manuell auf Ihrer Website anmelden muss.

Der Benutzer autorisiert einmal (in der Oberfläche des KI-Agenten), seine Liefer- und Kontaktinformationen zu teilen. Diese Informationen werden dann über kryptografisch signierte Token übertragen, die Sie über die UCP-Verifizierungs-API überprüfen. Ihr System speichert niemals Bankdaten, sondern nur das verifizierte Identitätstoken.

Schritt 3: AP2-Zahlungen konfigurieren

Für Stripe: Dashboard → Einstellungen → Agentic Payments → Agent Payments Protocol aktivieren. Konfigurieren Sie Transaktionslimits für vom Agenten initiierte Zahlungen (Höchstbetrag, berechtigte Kategorien).

Für Adyen: Kontaktieren Sie Ihren Account Manager, um das AP2-Profil zu aktivieren. Adyen erfordert eine vorherige Validierung Ihrer Katalog- und Bestandsendpunkte, bevor agentic payments aktiviert werden.

Schritt 4: Endpunkte für die Auftragsverwaltung freilegen

UCP erfordert eine Reihe von Endpunkten für die Nachkaufverwaltung, die KI-Agenten verwenden, um den Benutzer auf dem Laufenden zu halten:

  • GET /ucp/v1/orders/{order_id}, Echtzeit-Bestellstatus
  • POST /ucp/v1/orders/{order_id}/cancel, vom KI-Agenten initiierte Stornierung
  • GET /ucp/v1/orders/{order_id}/tracking, Lieferverfolgung

Schritt 5: Testen und Validierung

Das offizielle GitHub-Repository (github.com/Universal-Commerce-Protocol/ucp) enthält eine Konformitätstestsuite und einen KI-Agenten-Simulator. Vor der Live-Schaltung:

  1. Führen Sie die UCP-Testsuite auf allen Endpunkten aus
  2. Testen Sie Fehlerszenarien (nicht vorrätig, Zahlung abgelehnt, Timeout)
  3. Validieren Sie Identity Linking mit einem offiziellen Test-Token
  4. Überprüfen Sie die Antwortzeiten des Bestandsendpunkts unter Last
  5. Simulieren Sie einen vollständigen End-to-End-Kauf mit dem Agenten-Simulator

Häufige Fehler, die es zu vermeiden gilt

Unkontrollierte Timeouts. Ein Bestandsendpunkt, der länger als 500 ms antwortet, wird als unzuverlässig eingestuft. Verwenden Sie Redis oder einen ähnlichen Cache für häufig abgefragte Bestandsdaten.

Unsynchronisierter Lagerbestand. Die Anzeige von "verfügbar" für ein nicht vorrätiges Produkt führt zu einer schlechten Erfahrung und beeinträchtigt Ihren agentic reputation score.

Fehlende Rückgaberichtlinie. KI-Agenten vergleichen aktiv Rückgaberichtlinien zwischen Händlern. Ein fehlendes oder leeres returnPolicy-Feld benachteiligt Sie.

Keine Fehlerbehandlung beim Checkout. Der KI-Agent muss standardisierte Fehlercodes (nicht vorrätig, nicht verifizierte Identität, Zahlung abgelehnt) erhalten, um dem Benutzer Alternativen anbieten zu können.

Offizielle Ressourcen