Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Fysieke goederen verkopen: betalingsstromen

Les 7 van 14 Bijgewerkt op 3 november 2026 Ontwikkelaar
Op deze pagina
  1. Wat u mag verkopen
  2. Stroom 1: Externe betaling, de standaardroute
  3. Stroom 2: Eerder opgeslagen betaalmethoden
  4. Stroom 3: Het ChatGPT-afrekenvenster (private beta)
  5. De server is de bron van de waarheid
  6. Houd nuttige tools beschikbaar zonder UI
  7. Belangrijkste punten

Les herschreven op 3 november 2026 op basis van de Checkout API-referentie, de pagina UI toevoegen aan uw MCP-server en de Plugin-richtlijnen van OpenAI. De vorige versie behandelde de verkoop van abonnementen en digitale producten met verzonnen functies (defineProduct, commerceFlow) en een commissiestructuur van 30%/15% zonder bronnen. De huidige pluginregels beperken handel tot uitsluitend fysieke goederen, en de documentatie vermeldt geen commissies. Bronnen: Checkout API-referentie · Plugin-richtlijnen.

Wat u mag verkopen

Begin met de regel, want deze bepaalt al het andere. De publicatieregels van OpenAI zijn duidelijk: een plugin mag alleen handel drijven in fysieke goederen. Het verkopen van digitale producten of diensten—abonnementen, digitale inhoud, tokens, credits—is verboden, zowel direct als indirect (bijvoorbeeld via een freemium-upsell). Er geldt ook een lijst van verboden goederen en diensten (adult content, gokken, geneesmiddelen op recept, wapens, tabak en nicotine, gepirateerde software, misleidende financiële diensten, onder andere). Les 13 komt terug op wat een abonnementsdienst binnen deze grenzen nog wel kan doen.

Binnen dit kader documenteert OpenAI drie betalingsstromen.

Stroom 1: Externe betaling, de standaardroute

Externe betaling is de aanbevolen aanpak en is voor iedereen beschikbaar. De plugin-UI presenteert in aanmerking komende producten, bijvoorbeeld met een knop “Kopen”. Wanneer de gebruiker besluit tot aankoop over te gaan, leidt de interface hen door naar een afrekenomgeving die op uw eigen domein wordt gehost. Prijsstelling, incasso, belastingen, kortingen, verzending, restituties, ondersteuning en naleving blijven volledig uw verantwoordelijkheid. Na de aankoop kan de gebruiker terugkeren naar ChatGPT met zijn orderbevestiging of leveringsstatus.

Om deze link te openen, biedt ChatGPT de extensie window.openai.openExternal({ href }), die een gecontroleerde link opent in de browser van de gebruiker. U moet toegestane omleidingsbestemmingen declareren in _meta["openai/widgetCSP"].redirect_domains: het standaard _meta.ui.csp-beleid dekt dit geval niet. Voor een goedgekeurde bestemming voegt ChatGPT standaard een ?redirectUrl=…-parameter toe aan het adres; door redirectUrl: false in te stellen, voorkomt u dit.

function openPayment(cartUrl) {
  if (window.openai?.openExternal) {
    window.openai.openExternal({ href: cartUrl });
  } else {
    // Host mist deze extensie: laat de gebruiker de link kopiëren
    document.querySelector("#payment-link").textContent = cartUrl;
  }
}

De regels zijn specifiek: zolang geïntegreerde betaling niet openstaat voor uw plugin, is externe betaling de verplichte route. Geen enkele andere betalingsoplossing van derden mag binnen de plugin-UI worden geïntegreerd of gehost.

Stroom 2: Eerder opgeslagen betaalmethoden

Voor in aanmerking komende aankopen van fysieke goederen kan de UI de klant een betaalmethode aanbieden die hij eerder bij u heeft opgeslagen. De gebruiker selecteert deze methode en bevestigt de aankoop binnen ChatGPT, zonder het gesprek te verlaten. Uw MCP-server verwerkt de bestelling en retourneert de bindende bevestiging. Deze stroom kan opgeslagen betaalmethoden weergeven, maar kan geen nieuwe betaalgegevens verzamelen.

Stroom 3: Het ChatGPT-afrekenvenster (private beta)

Om een nieuwe betaalmethode binnen de stroom te verzamelen, hebt u het ChatGPT-afrekenvenster nodig. Deze geïntegreerde betalingsfunctie bevindt zich in private beta, is gereserveerd voor specifieke marktplaatsen en is niet toegankelijk voor alle ontwikkelaars of gebruikers. De werking ervan is het waard om te begrijpen, omdat deze de verdeling van rollen tussen de host en uw server illustreert:

  1. Een MCP-tool retourneert een betalingssessie in structuredContent.
  2. Het component toont artikelen, totalen, voorwaarden en verzendopties.
  3. Wanneer de gebruiker kiest om te betalen, roept het component window.openai.requestCheckout(session) aan; ChatGPT opent zijn afrekenvenster.
  4. Na validatie stuurt ChatGPT een token dat de gekozen betaalmethode vertegenwoordigt naar de tool complete_checkout van uw server. Deze tool incasseert via uw betalingsprovider en retourneert de definitieve bestelling—het resultaat dat het component ontvangt als reactie op requestCheckout.

De sessie moet een unieke identifier bevatten, artikelen en hun hoeveelheden, totalen in kleinste valuta-eenheden (centen, niet decimale euro’s), metadata van de betalingsprovider en handelaar, en verplichte links: voorwaarden, privacy, restituties en ondersteuning. ChatGPT voegt zijn eigen velden toe, zoals merchant of conversation_id.

De server is de bron van de waarheid

Ongeacht de stroom geldt dezelfde discipline:

  • Prijzen en orderstatus komen van de server, nooit van een totaal dat in het component is berekend.
  • Het betalingstoken wordt geverifieerd, de bewerking is idempotent—een dubbelklik mag niet twee keer leiden tot incasso—de bestelling wordt geregistreerd en een referentieontvangstbewijs wordt geretourneerd.
  • Annulering, weigering van betaling en providerfouten worden afgehandeld in het component. Voor het afrekenvenster worden fouten payment_declined en requires_3ds die door complete_checkout worden geretourneerd, direct weergegeven in het ChatGPT-venster.

Voor het afrekenvenster stelt payment_mode: "test" u in staat de end-to-end-stroom te testen met testkaarten zonder echt geld te verplaatsen.

Houd nuttige tools beschikbaar zonder UI

Zoals bij de rest van de plugin, moeten de catalogus- en bestelmogelijkheden toegankelijk blijven via tools die zonder component kunnen worden gebruikt. De UI dient om producten, prijzen, voorwaarden en betalingskeuzes te presenteren vóór bevestiging. Het vervangt geen robuuste data-tools en beslist nooit over een prijs.

Belangrijkste punten

  • Een plugin verkoopt alleen fysieke goederen: abonnementen, digitale inhoud, credits en freemium-upsells zijn verboden
  • Externe betaling op uw domein is de aanbevolen route die voor iedereen beschikbaar is; openExternal opent de link
  • Opgeslagen betaalmethoden kunnen worden aangeboden, niet verzameld
  • Het ChatGPT-afrekenvenster (requestCheckout + complete_checkout) bevindt zich in private beta, gereserveerd voor specifieke marktplaatsen
  • De server is de bron van de waarheid: prijsberekeningen aan serverzijde, idempotente bewerkingen, bedragen in kleinste eenheden