Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Predaj fyzického tovaru: platobné toky

Lekcia 7 z 14 Aktualizované 3. novembra 2026 Vývojár
Na tejto strane
  1. Čo môžeš predávať
  2. Tok 1: Externá platba, predvolená cesta
  3. Tok 2: Predtým uložené platobné metódy
  4. Tok 3: Pokladničný hárok ChatGPT (súkromná beta verzia)
  5. Server je zdrojom pravdy
  6. Udržiavaj užitočné nástroje dostupné bez UI
  7. Kľúčové poznatky

Lekcia prepísaná 3. novembra 2026 na základe referencie Checkout API, stránky Pridanie UI do vášho MCP servera a smerníc pre pluginy od OpenAI. Predchádzajúca verzia pokrývala predaj predplatného a digitálnych produktov pomocou vymyslených funkcií (defineProduct, commerceFlow) a štruktúrou provízií 30 %/15 % bez zdrojov. Aktuálne pravidlá pre pluginy obmedzujú obchod výlučne na fyzický tovar a dokumentácia nespomína žiadne provízie. Zdroje: Referencia Checkout API · Smernice pre pluginy.

Čo môžeš predávať

Začni pravidlom, pretože určuje všetko ostatné. Pravidlá publikovania od OpenAI sú jasné: plugin môže vykonávať obchod len s fyzickým tovarom. Predaj digitálnych produktov alebo služieb – predplatné, digitálny obsah, tokeny, kredity – je zakázaný, či už priamo alebo nepriamo (napríklad cez upsell vo verzii freemium). Platí aj zoznam zakázaného tovaru a služieb (obsah pre dospelých, hazardné hry, lieky na predpis, zbrane, tabak a nikotín, pirátsky softvér, zavádzajúce finančné služby a ďalšie). Lekcia 13 sa znovu venuje tomu, čo môže služba predplatného v rámci týchto limitov stále robiť.

V rámci tohto rámca OpenAI dokumentuje tri platobné toky.

Tok 1: Externá platba, predvolená cesta

Externá platba je odporúčaný prístup a je dostupný pre všetkých. UI pluginu zobrazuje produkty, ktoré je možné zakúpiť, napríklad tlačidlom „Kúpiť“. Keď sa používateľ rozhodne pre nákup, rozhranie ho presmeruje na pokladničnú bránu hostenú na tvojej vlastnej doméne. Ceny, výber platby, dane, zľavy, doprava, reklamácie, podpora a súlad s predpismi zostávajú výlučne tvojou zodpovednosťou. Po nákupe sa môže používateľ vrátiť do ChatGPT s potvrdením objednávky alebo sledovaním doručenia.

Na otvorenie tohto odkazu poskytuje ChatGPT rozšírenie window.openai.openExternal({ href }), ktoré otvorí kontrolovaný odkaz v prehliadači používateľa. Musíš deklarovať povolené cieľové domény presmerovania v _meta["openai/widgetCSP"].redirect_domains: štandardná politika _meta.ui.csp tento prípad nepokrýva. Pre schválenú destináciu ChatGPT štandardne pridá do adresy parameter ?redirectUrl=…; nastavením redirectUrl: false tomu zabrániš.

function openPayment(cartUrl) {
  if (window.openai?.openExternal) {
    window.openai.openExternal({ href: cartUrl });
  } else {
    // Hostiteľ nemá toto rozšírenie: nechaj používateľa skopírovať odkaz
    document.querySelector("#payment-link").textContent = cartUrl;
  }
}

Pravidlá sú špecifické: pokiaľ nie je integrovaná platba otvorená pre tvoj plugin, externá platba je povinnou cestou. Žiadne iné platobné riešenie tretej strany nemôže byť integrované ani hostené v rámci UI pluginu.

Tok 2: Predtým uložené platobné metódy

Pri oprávnených nákupoch fyzického tovaru môže UI ponúknuť zákazníkovi platobnú metódu, ktorú si u teba už uložil. Používateľ si túto metódu vyberie a potvrdí nákup priamo v ChatGPT bez opustenia konverzácie. Tvoj MCP server spracuje objednávku a vráti záväzné potvrdenie. Tento tok môže zobrazovať uložené platobné metódy, ale nemôže zbierať nové platobné údaje.

Tok 3: Pokladničný hárok ChatGPT (súkromná beta verzia)

Na získanie novej platobnej metódy v rámci toku potrebuješ pokladničný hárok ChatGPT. Táto funkcia integrovanej platby je v súkromnej beta verzii, vyhradená pre konkrétne trhoviská a nie je dostupná pre všetkých vývojárov ani používateľov. Jej fungovanie stojí za pochopenie, pretože ilustruje rozdelenie úloh medzi hostiteľom a tvojim serverom:

  1. Nástroj MCP vráti platobnú reláciu v structuredContent.
  2. Komponent zobrazí položky, súčty, podmienky a možnosti dopravy.
  3. Keď sa používateľ rozhodne zaplatiť, komponent zavolá window.openai.requestCheckout(session); ChatGPT otvorí svoj pokladničný hárok.
  4. Po overení ChatGPT pošle token predstavujúci zvolenú platobnú metódu do nástroja complete_checkout na tvojom serveri. Tento nástroj účtuje platbu cez tvojho poskytovateľa platieb a vráti finalizovanú objednávku – výsledok, ktorý komponent dostane ako odpoveď na requestCheckout.

Relácia musí obsahovať jedinečný identifikátor, položky a ich množstvá, súčty v menších menových jednotkách (centy, nie desatinné eurá), poskytovateľa platby a metadáta obchodníka, ako aj povinné odkazy: podmienky, ochrana súkromia, reklamácie a podpora. ChatGPT pridáva vlastné polia, ako sú merchant alebo conversation_id.

Server je zdrojom pravdy

Bez ohľadu na tok platí rovnaká disciplína:

  • Ceny a stav objednávky pochádzajú zo servera, nikdy zo súčtu vypočítaného v komponente.
  • Platobný token sa overí, operácia je idempotentná – dvojité kliknutie nesmie spôsobiť dvojité účtovanie – objednávka sa zaznamená a vráti sa referenčný doklad.
  • Zrušenie, odmietnutie platby a chyby poskytovateľa sa riešia v komponente. Pri pokladničnom hárku sa chyby payment_declined a requires_3ds vrátené nástrojom complete_checkout zobrazia priamo v hárku ChatGPT.

Pre pokladničný hárok umožňuje payment_mode: "test" otestovať tok end-to-end s testovacími kartami bez pohybu reálnych finančných prostriedkov.

Udržiavaj užitočné nástroje dostupné bez UI

Ako pri zvyšku pluginu, katalóg a možnosti objednania musia zostať dostupné prostredníctvom nástrojov použiteľných bez komponentu. UI slúži na prezentáciu produktov, cien, podmienok a možností platby pred potvrdením. Nenahrádza robustné dátové nástroje a nikdy nerozhoduje o cene.

Kľúčové poznatky

  • Plugin predáva iba fyzický tovar: predplatné, digitálny obsah, kredity a upsell vo verzii freemium sú zakázané
  • Externá platba na tvojej doméne je odporúčaná cesta dostupná pre všetkých; openExternal otvára odkaz
  • Uložené platobné metódy možno ponúknuť, nie zbierať
  • Pokladničný hárok ChatGPT (requestCheckout + complete_checkout) je v súkromnej beta verzii, vyhradený pre konkrétne trhoviská
  • Server je zdrojom pravdy: výpočty cien na strane servera, idempotentné operácie, sumy v menších jednotkách