Zum Inhalt springen
rocc

Universal Commerce Protocol · Version 2026-08-25

Dein Shop, gebaut für KI-Agenten.

Das Universal Commerce Protocol ist der offene Standard, mit dem KI-Agenten Shops finden, Produkte vergleichen und bestellen. Auf rocc ist es kein Zusatz, sondern der Kern: Jeder Shop spricht UCP ab dem ersten veröffentlichten Produkt.

Shop mit UCP eröffnenLive ausprobieren

Der Ablauf

Vom Auffinden bis zur Bestellung — vier Schritte, alle genormt.

  1. 01

    Entdecken

    GET /.well-known/ucp

    Der Agent findet deinen Shop über das Profil auf deiner eigenen Domain — mit Version, Endpunkten und Fähigkeiten.

  2. 02

    Katalog lesen

    POST /catalog/search · /lookup · /product

    Produkte, Varianten, Preise, Bilder und Optionen in der genormten UCP-Form — direkt aus deinem Studio, ohne Export.

  3. 03

    Warenkorb & Kasse

    POST /cart · /checkout-sessions

    Preise und Bestand prüft rocc serverseitig. Bezahlt wird über eine sichere Zahlungsseite — das Geld landet bei dir.

  4. 04

    Bestellung verfolgen

    POST /orders · Webhooks

    Der Agent fragt den Status ab oder bekommt ihn per Webhook — ohne Zugriff auf persönliche Daten deiner Kunden.

Live

Frag den Katalog — wie ein Agent es tut.

Die Anfrage geht an genau den Endpunkt, den ein KI-Agent benutzt, auf diesem Server. Die Antwort ist echt: Produkte aus Shops, die auf rocc laufen.

live · diese Domain
> POST /api/ucp/v1/catalog/search
{ "query": "Panettone", "pagination": { "limit": 3 } }

Für Entwickler

Die Endpunkte.

Jeder Shop hat sie auf seiner eigenen Domain. Basis: https://dein-shop.de/api/ucp/v1

Aufruf
GET/.well-known/ucp

Profil des Shops: Version, Dienste, Fähigkeiten, Schlüssel

POST/api/ucp/v1/catalog/search

Katalog durchsuchen, mit Filtern und Cursor

POST/api/ucp/v1/catalog/lookup

Mehrere Produkte nach ID, Handle oder SKU

POST/api/ucp/v1/catalog/product

Ein Produkt mit Größenauswahl und Verfügbarkeit

POST/api/ucp/v1/carts

Warenkorb anlegen — Preise und Bestand vom Server

GET · PUT/api/ucp/v1/carts/{id}

Warenkorb lesen und ersetzen

POST/api/ucp/v1/carts/{id}/cancel

Warenkorb verwerfen

POST/api/ucp/v1/checkout-sessions

Kasse starten, mit Idempotency-Key gegen Doppelbestellungen

GET · PUT/api/ucp/v1/checkout-sessions/{id}

Kasse lesen und ersetzen (Käufer, Adresse, Codes)

POST/api/ucp/v1/checkout-sessions/{id}/complete

Abschluss — bei rocc Übergabe an die Shop-Kasse

POST/api/ucp/v1/checkout-sessions/{id}/cancel

Kasse abbrechen

GET/api/ucp/v1/orders/{id}

Bestellung abfragen: Positionen, Sendungen, Erstattungen

Katalog durchsuchen

curl -X POST https://dein-shop.de/api/ucp/v1/catalog/search \
  -H "Content-Type: application/json" \
  -d '{ "query": "Panettone", "pagination": { "limit": 5 } }'

Kasse starten

curl -X POST https://dein-shop.de/api/ucp/v1/checkout-sessions \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 7f3c…" \
  -H 'UCP-Agent: profile="https://dein-agent.example/.well-known/ucp"' \
  -d '{ "line_items": [{ "item": { "id": "<varianten-id>" }, "quantity": 1 }] }'

# → { "status": "requires_escalation",
#     "continue_url": "https://dein-shop.de/ucp/checkout/<id>" }

Stand heute

Was läuft, was als Nächstes kommt.

Live

  • Profil, Katalog, Warenkorb, Kasse, Bestellung und Rabatte nach Release 2026-08-25
  • Jede Größe eine eigene Variante mit eigenem Preis, Bild und Bestand
  • Warenkorb und Kasse als gespeicherte Vorgänge: anlegen, lesen, ändern, abbrechen
  • Versandkosten und Lieferadresse über die Fulfillment-Erweiterung
  • Signierte Bestell-Ereignisse (RFC 9421) an den Agenten, mit Wiederholung
  • Prüfung eingehender Agenten-Signaturen, Aushandlung der Fähigkeiten, Idempotenz

In Vorbereitung

  • Bezahlen direkt im Agenten (Payment-Handler, z. B. über Google Pay)
  • MCP- und A2A-Transport zusätzlich zu REST

Fragen

Häufige Fragen zu UCP.

Muss ich für UCP etwas einrichten?

Nein. Jeder Shop liefert sein UCP-Profil automatisch aus — auf der rocc-Subdomain und auf deiner eigenen Domain —, und Agenten finden darüber alle veröffentlichten Produkte. Webhooks für Agenten trägst du bei Bedarf im Studio unter Einstellungen → Agenten-Webhooks ein.

Wer bezahlt, und wohin geht das Geld?

Der Agent startet die Kasse, bezahlt wird auf einer sicheren Zahlungsseite über Stripe. Das Geld geht an dein verbundenes Stripe-Konto, die Bestellung landet ganz normal in deinem Studio.

Kann ein Agent falsche Preise durchsetzen?

Nein. Der Agent schickt nur Produkt und Menge. Preise, Varianten und Bestand prüft rocc selbst — genau wie bei einer Bestellung im Shop.

Sieht ein Agent die Daten meiner Kunden?

Nein. Die Statusabfrage gibt Bestellnummer, Positionen und Summen zurück, aber weder E-Mail noch Adresse.

Welche Agenten können bei mir einkaufen?

Jeder, der UCP spricht. Es ist ein offener Standard — kein Vertrag mit einem einzelnen Anbieter, keine Sonderschnittstelle.

Sei da, wo Agenten einkaufen.

Eröffne deinen Shop auf rocc — UCP ist ab dem ersten Produkt dabei.

Shop eröffnenAlle Funktionen