Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Sälja fysiska varor: betalningsflöden

Lektion 7 av 14 Uppdaterad 3 november 2026 Utvecklare
På denna sida
  1. Vad du får sälja
  2. Flöde 1: Extern betalning, standardvägen
  3. Flöde 2: Tidigare sparade betalningsmetoder
  4. Flöde 3: ChatGPT kassasida (privat beta)
  5. Servern är källan till sanning
  6. Håll användbara verktyg tillgängliga utan UI
  7. Viktiga punkter

Lektionen omskriven den 3 november 2026 baserat på Checkout API-referensen, sidan Lägg till UI i din MCP-server och OpenAIs riktlinjer för plugin. Den tidigare versionen täckte försäljning av prenumerationer och digitala produkter med påhittade funktioner (defineProduct, commerceFlow) och en provisionsstruktur på 30 %/15 % utan källhänvisningar. Nuvarande regler för plugin begränsar handel till enbart fysiska varor, och dokumentationen nämner inga provisioner. Källor: Checkout API-referens · Riktlinjer för plugin.

Vad du får sälja

Börja med regeln, eftersom den styr allt annat. OpenAIs publiceringsregler är tydliga: ett plugin får endast utföra handel med fysiska varor. Försäljning av digitala produkter eller tjänster – prenumerationer, digitalt innehåll, tokens, krediter – är förbjudet, oavsett om det sker direkt eller indirekt (till exempel via en freemium-uppsäljning). En lista över förbjudna varor och tjänster gäller också (vuxeninnehåll, spel om pengar, receptbelagda läkemedel, vapen, tobak och nikotin, piratkopierad programvara, vilseledande finansiella tjänster, med flera). Lektion 13 återkommer till vad en prenumerationstjänst ändå kan göra inom dessa ramar.

Inom denna ram dokumenterar OpenAI tre betalningsflöden.

Flöde 1: Extern betalning, standardvägen

Extern betalning är den rekommenderade metoden och är tillgänglig för alla. Plugin-gränssnittet presenterar berättigade produkter, till exempel med en “Köp”-knapp. När användaren bestämmer sig för att köpa, omdirigerar gränssnittet dem till en kassa som hostas på din egen domän. Prissättning, insamling, skatter, rabatter, frakt, återbetalningar, support och efterlevnad är helt och hållet ditt ansvar. Efter köpet kan användaren återvända till ChatGPT med sin orderbekräftelse eller leveransspårning.

För att öppna denna länk tillhandahåller ChatGPT tillägget window.openai.openExternal({ href }), som öppnar en kontrollerad länk i användarens webbläsare. Du måste deklarera tillåtna omdirigeringsmål i _meta["openai/widgetCSP"].redirect_domains: den vanliga _meta.ui.csp-policyn täcker inte detta fall. För ett godkänt mål lägger ChatGPT som standard till en parameter ?redirectUrl=… i adressen; genom att sätta redirectUrl: false förhindras detta.

function openPayment(cartUrl) {
  if (window.openai?.openExternal) {
    window.openai.openExternal({ href: cartUrl });
  } else {
    // Värden saknar detta tillägg: låt användaren kopiera länken
    document.querySelector("#payment-link").textContent = cartUrl;
  }
}

Reglerna är specifika: så länge integrerad betalning inte är öppen för ditt plugin, är extern betalning den obligatoriska vägen. Ingen annan tredjepartslösning för betalning får integreras eller hostas inom plugin-gränssnittet.

Flöde 2: Tidigare sparade betalningsmetoder

För berättigade köp av fysiska varor kan gränssnittet erbjuda kunden en betalningsmetod som de redan har sparad hos dig. Användaren väljer denna metod och bekräftar köpet inom ChatGPT, utan att lämna konversationen. Din MCP-server bearbetar ordern och returnerar den bindande bekräftelsen. Detta flöde kan visa sparade betalningsmetoder, men det kan inte samla in nya betalningsuppgifter.

Flöde 3: ChatGPT kassasida (privat beta)

För att samla in en ny betalningsmetod inom flödet behöver du ChatGPT kassasida. Denna integrerade betalningsfunktion befinner sig i privat beta, är reserverad för specifika marknadsplatser och är inte tillgänglig för alla utvecklare eller användare. Dess funktion är värd att förstå eftersom den illustrerar ansvarsfördelningen mellan värden och din server:

  1. Ett MCP-verktyg returnerar en betalningssession i structuredContent.
  2. Komponenten visar artiklar, summor, villkor och fraktalternativ.
  3. När användaren väljer att betala, anropar komponenten window.openai.requestCheckout(session); ChatGPT öppnar sin kassasida.
  4. Efter validering skickar ChatGPT en token som representerar den valda betalningsmetoden till din servers verktyg complete_checkout. Detta verktyg debiterar via din betalningsleverantör och returnerar den finaliserade ordern – resultatet som komponenten får som svar på requestCheckout.

Sessionen måste innehålla en unik identifierare, artiklar och deras kvantiteter, summor i minsta valutaenhet (öre, inte decimala euro), betalningsleverantör och handlarmetadata, samt obligatoriska länkar: villkor, integritet, återbetalningar och support. ChatGPT lägger till sina egna fält, såsom merchant eller conversation_id.

Servern är källan till sanning

Oavsett flöde gäller samma disciplin:

  • Priser och orderstatus kommer från servern, aldrig från en summa beräknad i komponenten.
  • Betalningstoken verifieras, operationen är idempotent – ett dubbelklick får inte leda till dubbel debitering – ordern registreras och ett referenskvitto returneras.
  • Avbokning, betalningsvägran och leverantörsfel hanteras i komponenten. För kassasidan visas felkoderna payment_declined och requires_3ds som returneras av complete_checkout direkt i ChatGPT-sidan.

För kassasidan tillåter payment_mode: "test" dig att testa hela flödet från början till slut med testkort utan att flytta riktiga medel.

Håll användbara verktyg tillgängliga utan UI

Precis som för resten av plugin måste katalog- och beställningsfunktionerna förbli tillgängliga via verktyg som kan användas utan en komponent. UI:t tjänar till att presentera produkter, priser, villkor och betalningsval före bekräftelse. Det ersätter inte robusta dataverktyg och det avgör aldrig ett pris.

Viktiga punkter

  • Ett plugin säljer endast fysiska varor: prenumerationer, digitalt innehåll, krediter och freemium-uppsäljningar är förbjudna
  • Extern betalning på din domän är den rekommenderade vägen som är tillgänglig för alla; openExternal öppnar länken
  • Sparade betalningsmetoder kan erbjudas, inte samlas in
  • ChatGPT kassasida (requestCheckout + complete_checkout) är i privat beta, reserverad för specifika marknadsplatser
  • Servern är källan till sanning: priskalkylering på serversidan, idempotenta operationer, belopp i minsta enheter