Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Verkauf physischer Güter: Zahlungsabläufe

Lektion 7 von 14 Aktualisiert am 3. November 2026 Entwickler
Auf dieser Seite
  1. Was Sie verkaufen können
  2. Ablauf 1: Externer Zahlungsverkehr, der Standardpfad
  3. Ablauf 2: Vorher gespeicherte Zahlungsmethoden
  4. Ablauf 3: Das ChatGPT-Checkout-Blatt (Private Beta)
  5. Der Server ist die einzige Wahrheit
  6. Nützliche Tools ohne Benutzeroberfläche verfügbar halten
  7. Kernaussagen

Lektion am 3. November 2026 neu überarbeitet basierend auf der Checkout API-Referenz, der Seite Benutzeroberfläche für Ihren MCP-Server hinzufügen und den Plugin-Richtlinien von OpenAI. Die vorherige Version behandelte den Verkauf von Abonnements und digitalen Produkten unter Verwendung erfundener Funktionen (defineProduct, commerceFlow) und einer Provisionstruktur von 30 %/15 % ohne Quellenangaben. Die aktuellen Plugin-Regelungen beschränken den Handel ausschließlich auf physische Güter, und die Dokumentation erwähnt keine Provisionen. Quellen: Checkout API-Referenz · Plugin-Richtlinien.

Was Sie verkaufen können

Beginnen Sie mit der Regel, da sie alles Weitere bestimmt. Die Veröffentlichungsregeln von OpenAI sind klar: Ein Plugin darf Handel ausschließlich für physische Güter tätigen. Der Verkauf digitaler Produkte oder Dienstleistungen – Abonnements, digitale Inhalte, Token, Guthaben – ist verboten, sei es direkt oder indirekt (beispielsweise über ein Freemium-Upgrade). Es gilt zudem eine Liste verbotener Güter und Dienstleistungen (erwachsene Inhalte, Glücksspiel, verschreibungspflichtige Medikamente, Waffen, Tabak und Nikotin, piratierter Software, irreführende Finanzdienstleistungen und andere mehr). In Lektion 13 wird besprochen, was ein Abonnementdienst innerhalb dieser Grenzen noch tun kann.

In diesem Rahmen dokumentiert OpenAI drei Zahlungsabläufe.

Ablauf 1: Externer Zahlungsverkehr, der Standardpfad

Externer Zahlungsverkehr ist der empfohlene Ansatz und für alle verfügbar. Die Plugin-Benutzeroberfläche zeigt berechtigte Produkte an, beispielsweise mit einem „Kaufen”-Button. Wenn der Nutzer beschließt, zu kaufen, leitet die Schnittstelle ihn zu einem Checkout-Tunnel weiter, der auf Ihrer eigenen Domain gehostet wird. Preisgestaltung, Erhebung, Steuern, Rabatte, Versand, Rückerstattungen, Support und Compliance bleiben vollständig Ihre Verantwortung. Nach dem Kauf kann der Nutzer zu ChatGPT zurückkehren mit seiner Bestellbestätigung oder dem Versandverfolgungsstatus.

Um diesen Link zu öffnen, stellt ChatGPT die Erweiterung window.openai.openExternal({ href }) bereit, die einen kontrollierten Link im Browser des Nutzers öffnet. Sie müssen erlaubte Weiterleitungsziele in _meta["openai/widgetCSP"].redirect_domains deklarieren: Die Standard-Richtlinie _meta.ui.csp deckt diesen Fall nicht ab. Für ein genehmigtes Ziel fügt ChatGPT standardmäßig einen Parameter ?redirectUrl=… zur Adresse hinzu; das Setzen von redirectUrl: false verhindert dies.

function openPayment(cartUrl) {
  if (window.openai?.openExternal) {
    window.openai.openExternal({ href: cartUrl });
  } else {
    // Der Host verfügt nicht über diese Erweiterung: Lassen Sie den Nutzer den Link kopieren
    document.querySelector("#payment-link").textContent = cartUrl;
  }
}

Die Regeln sind spezifisch: Solange integrierter Zahlungsverkehr für Ihr Plugin nicht freigegeben ist, ist der externe Zahlungsverkehr der verbindliche Pfad. Keine andere Drittanbieter-Zahlungslösung kann in der Plugin-Benutzeroberfläche integriert oder gehostet werden.

Ablauf 2: Vorher gespeicherte Zahlungsmethoden

Für berechtigte Käufe physischer Güter kann die Benutzeroberfläche dem Kunden eine Zahlungsmethode anbieten, die er bereits bei Ihnen gespeichert hat. Der Nutzer wählt diese Methode aus und bestätigt den Kauf innerhalb von ChatGPT, ohne den Chatverlauf zu verlassen. Ihr MCP-Server verarbeitet die Bestellung und gibt die verbindliche Bestätigung zurück. Dieser Ablauf kann gespeicherte Zahlungsmethoden anzeigen, aber keine neuen Zahlungsdetails erheben.

Ablauf 3: Das ChatGPT-Checkout-Blatt (Private Beta)

Um innerhalb des Ablaufs eine neue Zahlungsmethode zu erheben, benötigen Sie das ChatGPT-Checkout-Blatt. Diese integrierte Zahlungsfunktion befindet sich in Private Beta, ist für bestimmte Marktplätze reserviert und steht nicht allen Entwicklern oder Nutzern zur Verfügung. Ihr Verständnis ihrer Funktionsweise lohnt sich, da sie die Aufgabenteilung zwischen dem Host und Ihrem Server veranschaulicht:

  1. Ein MCP-Tool gibt eine Zahlungssitzung in structuredContent zurück.
  2. Das Komponente zeigt Artikel, Gesamtbeträge, Bedingungen und Versandoptionen an.
  3. Wenn der Nutzer beschließt zu zahlen, ruft die Komponente window.openai.requestCheckout(session) auf; ChatGPT öffnet sein Checkout-Blatt.
  4. Nach der Validierung sendet ChatGPT einen Token, der die gewählte Zahlungsmethode repräsentiert, an das Tool complete_checkout Ihres Servers. Dieses Tool belastet über Ihren Zahlungsanbieter und gibt die finalisierte Bestellung zurück – das Ergebnis, das die Komponente als Antwort auf requestCheckout erhält.

Die Sitzung muss einen eindeutigen Identifier, Artikel und deren Mengen, Gesamtbeträge in kleinen Währungseinheiten (Cent, nicht Dezimaleuro), Zahlungsanbieter und Händler-Metadaten sowie verbindliche Links enthalten: Bedingungen, Datenschutz, Rückerstattungen und Support. ChatGPT fügt eigene Felder hinzu, wie merchant oder conversation_id.

Der Server ist die einzige Wahrheit

Unabhängig vom Ablauf gilt dieselbe Disziplin:

  • Preise und Bestellstatus stammen vom Server, niemals von einem im Komponente berechneten Gesamtbetrag.
  • Der Zahlungstoken wird verifiziert, die Operation ist idempotent – ein Doppelklick darf nicht zweimal belasten – die Bestellung wird aufgezeichnet, und eine Referenzrechnung wird zurückgegeben.
  • Stornierung, Zahlungsausschlag und Anbieterfehler werden in der Komponente behandelt. Für das Checkout-Blatt werden die Fehler payment_declined und requires_3ds, die von complete_checkout zurückgegeben werden, direkt im ChatGPT-Blatt angezeigt.

Für das Checkout-Blatt ermöglicht payment_mode: "test" das Testen des End-to-End-Ablaufs mit Testkarten, ohne dass echte Gelder bewegt werden.

Nützliche Tools ohne Benutzeroberfläche verfügbar halten

Wie beim Rest des Plugins müssen die Katalog- und Bestellfunktionen auch über Tools zugänglich bleiben, die ohne eine Komponente nutzbar sind. Die Benutzeroberfläche dient dazu, Produkte, Preise, Bedingungen und Zahlungsoptionen vor der Bestätigung darzustellen. Sie ersetzt keine robusten Datentools und entscheidet niemals über einen Preis.

Kernaussagen

  • Ein Plugin verkauft ausschließlich physische Güter: Abonnements, digitale Inhalte, Guthaben und Freemium-Upgrades sind verboten
  • Externer Zahlungsverkehr auf Ihrer Domain ist der empfohlene Pfad, der für alle verfügbar ist; openExternal öffnet den Link
  • Gespeicherte Zahlungsmethoden können angeboten, aber nicht erhoben werden
  • Das ChatGPT-Checkout-Blatt (requestCheckout + complete_checkout) befindet sich in Private Beta und ist für bestimmte Marktplätze reserviert
  • Der Server ist die einzige Wahrheit: Serverseitige Preisberechnungen, idempotente Operationen, Beträge in kleinen Einheiten