Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Salg af fysiske varer: betalingsforløb

Lektion 7 af 14 Opdateret 3. november 2026 Udvikler
På denne side
  1. Hvad du kan sælge
  2. Forløb 1: Ekstern betaling, standardvejen
  3. Forløb 2: Tidligere gemte betalingsmetoder
  4. Forløb 3: ChatGPT-kassesiden (privat beta)
  5. Serveren er den eneste sandhedskilde
  6. Hold nyttige værktøjer tilgængelige uden UI
  7. Vigtige pointer

Lektionen er omskrevet den 3. november 2026 baseret på Checkout API-referencen, siden Tilføj UI til din MCP-server og OpenAIs Plugin-retningslinjer. Den tidligere version dækkede salg af abonnementer og digitale produkter ved hjælp af opdigtede funktioner (defineProduct, commerceFlow) og en kommissionsstruktur på 30 %/15 % uden kilder. Nuværende plugin-regler begrænser handel til udelukkende fysiske varer, og dokumentationen nævner ingen kommissioner. Kilder: Checkout API-reference · Plugin-retningslinjer.

Hvad du kan sælge

Start med reglen, for den styrer alt andet. OpenAIs publiceringsregler er klare: et plugin kan kun udføre handel med fysiske varer. Det er forbudt at sælge digitale produkter eller tjenester – abonnementer, digitalt indhold, tokens, credits – hverken direkte eller indirekte (f.eks. via en freemium-opgradering). En liste over forbudte varer og tjenester gælder også (voksent indhold, spil, receptpligtig medicin, våben, tobak og nikotin, piratkopieret software, vildledende finansielle tjenester, blandt andre). Lektion 13 vender tilbage til, hvad en abonnementstjeneste stadig kan gøre inden for disse grænser.

Inden for denne ramme dokumenterer OpenAI tre betalingsforløb.

Forløb 1: Ekstern betaling, standardvejen

Ekstern betaling er den anbefalede tilgang og er tilgængelig for alle. Plugin-UI’et præsenterer berettigede produkter, f.eks. med en „Køb”-knap. Når brugeren beslutter sig for at købe, omdirigerer grænsefladen dem til en kassetunnel hostet på dit eget domæne. Prissætning, opkrævning, skatter, rabatter, fragt, refusioner, support og overholdelse af reglerne er udelukkende dit ansvar. Efter købet kan brugeren vende tilbage til ChatGPT med sin ordrebekræftelse eller leveringsstatus.

For at åbne dette link stiller ChatGPT udvidelsen window.openai.openExternal({ href }) til rådighed, som åbner et kontrolleret link i brugerens browser. Du skal deklarere tilladte omdirigeringsdestinationer i _meta["openai/widgetCSP"].redirect_domains: standardpolitikken _meta.ui.csp dækker ikke dette tilfælde. For en godkendt destination tilføjer ChatGPT som standard en ?redirectUrl=…-parameter til adressen; indstillingen redirectUrl: false forhindrer dette.

function openPayment(cartUrl) {
  if (window.openai?.openExternal) {
    window.openai.openExternal({ href: cartUrl });
  } else {
    // Værten mangler denne udvidelse: lad brugeren kopiere linket
    document.querySelector("#payment-link").textContent = cartUrl;
  }
}

Reglerne er specifikke: Så længe integreret betaling ikke er åben for dit plugin, er ekstern betaling den obligatoriske vej. Ingen anden tredjepartsbetalingsløsning kan integreres eller hostes inden for plugin-UI’et.

Forløb 2: Tidligere gemte betalingsmetoder

Ved berettigede køb af fysiske varer kan UI’et tilbyde kunden en betalingsmetode, de allerede har gemt hos dig. Brugeren vælger denne metode og bekræfter købet inden for ChatGPT uden at forlade samtalen. Din MCP-server behandler ordren og returnerer den bindende bekræftelse. Dette forløb kan vise gemte betalingsmetoder, men det kan ikke indhente nye betalingsoplysninger.

Forløb 3: ChatGPT-kassesiden (privat beta)

For at indhente en ny betalingsmetode inden for forløbet har du brug for ChatGPT-kassesiden. Denne integrerede betalingsfunktion er i privat beta, forbeholdt specifikke markedspladser, og er ikke tilgængelig for alle udviklere eller brugere. Dens funktion er værd at forstå, fordi den illustrerer arbejdsdelingen mellem værten og din server:

  1. Et MCP-værktøj returnerer en betalingssession i structuredContent.
  2. Komponenten viser varer, totalbeløb, vilkår og fragtmuligheder.
  3. Når brugeren vælger at betale, kalder komponenten window.openai.requestCheckout(session); ChatGPT åbner sin kasseside.
  4. Efter validering sender ChatGPT et token, der repræsenterer den valgte betalingsmetode, til din servers complete_checkout-værktøj. Dette værktøj opkræver betaling via din betalingsudbyder og returnerer den færdige ordre – resultatet, som komponenten modtager som svar på requestCheckout.

Sessionen skal indeholde en unik identifikator, varer og deres antal, totalbeløb i mindre valutaenheder (cent, ikke decimal-euro), betalingsudbyder og merchant-metadata samt obligatoriske links: vilkår, privatlivspolitik, refusion og support. ChatGPT tilføjer sine egne felter, såsom merchant eller conversation_id.

Serveren er den eneste sandhedskilde

Uanset forløbet gælder den samme disciplin:

  • Priser og ordrestatus kommer fra serveren, aldrig fra en total beregnet i komponenten.
  • Betalingstokennet verificeres, operationen er idempotent – et dobbeltklik må ikke opkræve to gange – ordren registreres, og en referencekvittering returneres.
  • Annullering, betalingsafvisning og udbyderfejl håndteres i komponenten. For kassesiden vises fejl payment_declined og requires_3ds, returneret af complete_checkout, direkte i ChatGPT-siden.

For kassesiden tillader payment_mode: "test" dig at teste hele forløbet end-to-end med testkort uden at flytte rigtige midler.

Hold nyttige værktøjer tilgængelige uden UI

Som med resten af pluginnet skal katalog- og ordrefunktioner forblive tilgængelige via værktøjer, der kan bruges uden en komponent. UI’et tjener til at præsentere produkter, priser, vilkår og betalingsvalg før bekræftelse. Det erstatter ikke robuste dataværktøjer, og det afgør aldrig en pris.

Vigtige pointer

  • Et plugin sælger kun fysiske varer: abonnementer, digitalt indhold, credits og freemium-opgraderinger er forbudt
  • Ekstern betaling på dit domæne er den anbefalede vej, der er tilgængelig for alle; openExternal åbner linket
  • Gemte betalingsmetoder kan tilbydes, ikke indhentes
  • ChatGPT-kassesiden (requestCheckout + complete_checkout) er i privat beta, forbeholdt specifikke markedspladser
  • Serveren er den eneste sandhedskilde: prissætning på serversiden, idempotente operationer, beløb i mindre enheder