Den vollständigen Index der Dokumentation findest du in llms.txt. Die Markdown-Version einer Dokumentationsseite erhältst du, indem du .md an die URL der Seite anhängst.
Hauptnavigation
Design

Spezifikation für den Kaufabschluss in ChatGPT

Schnittstellenanforderungen für die Integration eines Checkout-Plugins in den Kaufablauf von ChatGPT.

Checkout-Plugins für ChatGPT befinden sich derzeit in der Betaphase. Wir testen sie gemeinsam mit zugelassenen Partnerunternehmen. Fülle das Formular aus, um Zugang zu beantragen.

Zum Antragsformular

Ziel

ChatGPT soll Plugins von Partnerunternehmen direkt aufrufen können, wenn eine klare Kaufabsicht besteht, etwa beim Checkout.

Sobald uns Partnerunternehmen einen Produktfeed für die Suche bereitstellen, können wir ihre MCP-Server anbinden, um Aktionen zum Kaufabschluss auszuführen. Dafür müssen die Plugins einheitliche Vorgaben für den Namen des Widgets, den Namen des Tools und die Eingabedaten des Tools erfüllen.

Wenn du ein Plugin nach dieser Spezifikation entwickeln möchtest, beantrage den Zugang über das ChatGPT-Formular für Handelsunternehmen.

Kaufablauf aus Nutzersicht

Bei der Produktsuche kann die Seitenleiste mit den Produktdetails für einzelne Shops die Schaltfläche „Öffnen“ anzeigen. Hat ein Shop ein Plugin, kann ChatGPT es direkt im Chat für den Checkout öffnen, ohne auf eine externe Website weiterzuleiten.

Aktuelle Schnittstellenanforderungen

  • Widget-Name: ui://widget/checkout-session.html
  • Tool-Name: checkout_session

checkout_session muss die Ressourcen-URI wie folgt setzen:

_meta.ui.resourceUri = "ui://widget/checkout-session.html";

Für jedes Tool, das direkt aus einem Widget aufgerufen wird, musst du den Zugriff wie folgt aktivieren:

_meta["openai/widgetAccessible"] = true;

Eingabedaten für checkout_session

Für jede Position im Checkout sind nur id und quantity erforderlich. offerId und die Metadaten zum ausgewählten Shopangebot sind optional:

{
  "checkout_session": {
    "items": [
      {
        "id": "string",
        "quantity": 1,
        "offerId": "string",
        "name": "Wireless headphones",
        "description": "Wireless headphones with noise cancellation.",
        "images": [
          "https://merchant.example.com/images/headphones.jpg",
          "https://merchant.example.com/images/headphones-side.jpg"
        ],
        "url": "https://merchant.example.com/products/headphones",
        "merchant_name": "Example Merchant",
        "price": "$24.99"
      }
    ]
  }
}

Die folgenden Felder sind für jede Position optional:

Feld Beschreibung
offerId Die ID des ausgewählten Shopangebots.
name Der Produktname im ausgewählten Angebot.
description Eine Beschreibung aus dem eigenen Feed des Shops.
images Geordnete Liste der Bild-URLs aus dem Feed des Shops. Die erste URL verweist auf das Hauptbild.
url Die URL des ausgewählten Shopangebots.
merchant_name Der Name des ausgewählten Shops.
price Der angezeigte Angebotspreis als Zeichenfolge.

images enthält null oder mehr URLs aus dem Feed des ausgewählten Shops. Ist mindestens eine URL vorhanden, zeigt ChatGPT das Bild unter der ersten URL als Hauptbild an. ChatGPT lässt optionale Felder weg, wenn die entsprechenden Daten fehlen. Es generiert keine Beschreibung und übernimmt weder Beschreibungen noch Bilder von anderen Shops. Deklariere diese Felder im Eingabeschema deines Tools als optional. Verwende die IDs der Checkout-Positionen und der Angebote, um die maßgeblichen Produkt-, Bestands- und Preisdaten aus deinem eigenen Katalog abzurufen.

Die verschachtelte Checkout-Sitzung verwendet die Datenstruktur, die in der früheren Checkout-Spezifikation beim Endpunkt zum Erstellen einer Sitzung beschrieben ist.