Zum Inhalt springen
rocc

Universal Commerce Protocol · Version 2026-01-01

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", "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

POST/api/ucp/v1/catalog/search

Katalog durchsuchen, seitenweise

POST/api/ucp/v1/catalog/lookup

Bis zu 100 Produkte auf einmal nach ID

POST/api/ucp/v1/catalog/product

Ein Produkt mit Optionen und Varianten

POST/api/ucp/v1/cart

Warenkorb bepreisen — Preise und Bestand vom Server

POST/api/ucp/v1/checkout-sessions

Kasse starten, mit Idempotency-Key gegen Doppelbestellungen

POST/api/ucp/v1/orders

Bestellstatus abfragen — ohne personenbezogene Daten

Katalog durchsuchen

curl -X POST https://dein-shop.de/api/ucp/v1/catalog/search \
  -H "Content-Type: application/json" \
  -d '{ "query": "Panettone", "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…" \
  -d '{ "line_items": [{ "item": { "id": "<produkt-id>" }, "quantity": 1 }] }'

# → { "status": "requires_escalation",
#     "links": [{ "type": "redirect", "url": "<Zahlungsseite>" }] }

Stand heute

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

Live

  • Ein Profil pro Shop, auf Subdomain und eigener Domain
  • Katalogsuche, Sammelabfrage und Produktdetail
  • Warenkorb mit serverseitiger Preis- und Bestandsprüfung
  • Checkout mit Übergabe an eine sichere Zahlungsseite
  • Bestellstatus und signierte Webhooks (order.paid, order.cancelled, order.refunded)
  • Rate-Limits auf allen API-Aufrufen, Idempotenz beim Checkout

In Vorbereitung

  • Bezahlen direkt im Agenten über AP2-Zahlungsanbieter
  • Signierte Anfragen und Schlüssel im Profil

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 kostenlos eröffnenAlle Funktionen