home

Monetarisierung von ChatGPT‑Apps: Externe Checkout‑Logik vs. Instant Checkout

Key Takeaway

Bei der Monetarisierung von ChatGPT‑Apps empfiehlt OpenAI die Nutzung von externer Checkout‑Logik, bei der der Einkauf über die eigene Domain abgewickelt wird; Instant Checkout ist aktuell nur in Private‑Beta verfügbar.

Summary

  • Allgemeines Ziel: Entwicklern wird ermöglicht, ihre ChatGPT‑Apps finanziell zu betreiben.
  • Empfohlener Ansatz:
    • Externe Checkout‑Logik: Nach dem Kauf in ChatGPT die Nutzer zu einer on‑site‑Checkout-URL umleiten.
    • Der Entwickler kontrolliert Preis, Zahlung, Abonnements und Erfüllung.
  • Instant Checkout (Beta): Nur für ausgewählte Marktplatzpartner. Einsatz der requestCheckout-Funktion im Widget, um eine Instant‑Checkout‑UI aufzurufen.
  • Der Token für die Zahlungsmethode wird per complete_checkout an den MCP‑Server zurückgeschickt. Der MCP‑Server nutzt den PSP (z. B. Stripe, Adyen), um zu belasten und eine Bestellbestätigung zurückzugeben.
  • Checkout‑Session: Der Tool‑Antwort-Body muss structuredContent mit Zeilenartikeln, Totals, Provider‑Metadaten, rechtlichen Links und anderen Feldwerten enthalten.
  • Widget‑Aufruf: const order = await window.openai.requestCheckout({ ...session, id: checkout_session_id });
  • MCP‑Server‑Tool complete_checkout: Implementiert die Logik zur Zahlungsabwicklung und Bestellpersistenz. Gibt structuredContent mit Status “completed” und Order‑Daten zurück.
  • Fehlerbehandlung: Fehler mit Codes payment_declined oder requires_3ds werden im Instant‑Checkout‑UI angezeigt. Andere Fehler kommen zurück und können im Widget verarbeitet werden.
  • Test‑Payment-Modus: Durch Setzen von payment_mode: "test" werden Testkarten akzeptiert. Ideal für End‑to‑End‑Tests ohne reale Zahlungen.
  • Implementierungscheckliste:
    1. Checkout‑Session‑Modell definieren (IDs, Provider, Zeilen, Totals, Links).
    2. Session im structuredContent zurückgeben.
    3. Session im Widget rendern – Zeilen, Totals, Bedingungen.
    4. requestCheckout bei Benutzereingabe aufrufen.
    5. complete_checkout im MCP‑Server implementieren – PSP‑Integration, Persistenz, Antwort.
    6. End‑to‑End‑Tests mit realistischen Beträgen, Steuern und Rabatten durchführen.
  • Related Queries:
    • Wie richte ich die complete_checkout-Methode auf meinem MCP‑Server ein?
    • Welche Felder muss ich für payment_provider in der Checkout‑Session-Payload setzen?
    • Unter welchen Bedingungen werden Instants‑Checkout‑Fehler im UI angezeigt?

Quelle: OpenAI Entwickler Dokumentation