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.

Redaktion · Aktualisiert : April 2026 · Hauptsuchanfrage : UCP implementieren

UCP-Integration auf Basis der aktuellen Spezifikation

Der Aufwand hängt von Ihrem bestehenden Katalog-, Checkout-, Identitäts-, Zahlungs- und Bestellsystem ab. Die UCP-Spezifikation veröffentlicht keine allgemeine Implementierungsdauer und keine pauschale Prozessor-Kompatibilität.

1. Profil veröffentlichen

Veröffentlichen Sie das Unternehmensprofil unter /.well-known/ucp über HTTPS ohne Weiterleitung. Geben Sie die unterstützte Protokollversion, Fähigkeiten, Transportarten, Schemas und Basis-Endpunkte an. Clients und Unternehmen handeln Version und Fähigkeiten für jede Interaktion aus.

2. REST-Operationen aus dem Profil ableiten

  • POST /catalog/search sucht Produkte.
  • POST /catalog/lookup löst Produkt- oder Varianten-IDs auf.
  • POST /checkout-sessions erstellt eine Checkout-Session.
  • GET /orders/{id} liefert den aktuellen Bestellstatus.

Alle Pfade sind relativ zum im Profil angegebenen Basis-Endpunkt. Verfügbarkeit und Preis müssen beim Checkout erneut geprüft werden.

3. Identität und Zahlungen korrekt begrenzen

Identity Linking verwendet OAuth 2.0 und Scopes. AP2 ist eine optionale Checkout-Erweiterung mit signierten Checkout- und Payment-Mandates. Prüfen Sie die konkrete Unterstützung in der aktuellen Dokumentation Ihres Zahlungsanbieters.

4. Vor dem Start testen

Validieren Sie Profil, Cache-Header, Versionsauswahl, Capability-Pruning, JSON-Schemas, Authentifizierung, HTTP-Signaturen und Fehlerantworten. Verwenden Sie eigene Vertrags- und Integrationstests; die Spezifikation definiert keine zentrale Zertifizierungssuite.

Offizielle Quellen