Prodaja fizičnega blaga: plačilni tokovi
Na tej strani
Lekcija je bila 3. novembra 2026 popolnoma prenovljena na podlagi referenčne dokumentacije za Checkout API, strani Dodajanje uporabniškega vmesnika strežniku MCP in smernic OpenAI za vtičnike. Prejšnja različica je obravnavala prodajo naročnin in digitalnih izdelkov z uporabo izmišljenih funkcij (
defineProduct,commerceFlow) ter strukturo provizij 30 %/15 % brez virov. Trenutna pravila za vtičnike omejujejo trgovanje izključno na fizično blago, dokumentacija pa ne omenja nobenih provizij. Viri: Referenčna dokumentacija za Checkout API · Smernice za vtičnike.
Kaj lahko prodajaš
Začni s pravilom, saj to določa vse ostalo. Pravila objave OpenAI so jasna: vtičnik lahko opravlja trgovinske dejavnosti izključno za fizično blago. Prodaja digitalnih izdelkov ali storitev – naročnin, digitalnih vsebin, žetonov, kreditov – je prepovedana, bodisi neposredno ali posredno (na primer prek nadgradnje freemium). Velja tudi seznam prepovedanega blaga in storitev (vsebine za odrasle, igre na srečo, zdravila na recept, orožje, tobak in nikotin, piratska programska oprema, zavajajoče finančne storitve med drugimi). Lekcija 13 ponovno obravnava, kaj lahko storitev naročnine še vedno počne znotraj teh omejitev.
V tem okviru OpenAI dokumentira tri plačilne tokove.
Tok 1: Zunanje plačilo, privzeta pot
Zunanje plačilo je priporočeni pristop in je na voljo vsem. Uporabniški vmesnik vtičnika prikaže izdelke, ki jih je mogoče kupiti, na primer z gumbom „Kupi”. Ko se uporabnik odloči za nakup, ga vmesnik preusmeri na blagajno, ki gostuje na tvoji lastni domeni. Določanje cen, pobiranje plačil, davki, popusti, dostava, vračila, podpora in skladnost so v celoti tvoja odgovornost. Po nakupu se lahko uporabnik vrne v ChatGPT s potrdilom o naročilu ali sledenjem dostave.
Za odpiranje te povezave ChatGPT ponuja razširitev window.openai.openExternal({ href }), ki odpre nadzorovano povezavo v uporabnikovem brskalniku. Dovoljene ciljne domene za preusmeritev moraš navesti v _meta["openai/widgetCSP"].redirect_domains: standardna politika _meta.ui.csp tega primera ne pokriva. Za odobreno destinacijo ChatGPT privzeto doda parameter ?redirectUrl=… k naslovu; nastavitev redirectUrl: false to prepreči.
function openPayment(cartUrl) {
if (window.openai?.openExternal) {
window.openai.openExternal({ href: cartUrl });
} else {
// Gostitelj nima te razširitve: dovoli uporabniku, da kopira povezavo
document.querySelector("#payment-link").textContent = cartUrl;
}
}
Pravila so specifična: dokler integrirano plačilo ni odprto za tvoj vtičnik, je zunanje plačilo obvezna pot. Nobene druge plačilne rešitve tretjih oseb ni mogoče integrirati ali gostiti znotraj uporabniškega vmesnika vtičnika.
Tok 2: Predhodno shranjeni načini plačila
Za upravičene nakupe fizičnega blaga lahko uporabniški vmesnik kupcu ponudi način plačila, ki ga je že shranil pri tebi. Uporabnik izbere ta način in potrdi nakup znotraj ChatGPT, ne da bi zapustil pogovor. Tvoj strežnik MCP obdela naročilo in vrne zavezujočo potrditev. Ta tok lahko prikaže shranjene načine plačila, ne more pa zbirati novih plačilnih podatkov.
Tok 3: List za blagajno ChatGPT (zasebna beta)
Če želiš znotraj toka zbrati nov način plačila, potrebuješ list za blagajno ChatGPT. Ta funkcija integriranega plačila je v zasebni beti, rezervirana za določene tržnice in ni dostopna vsem razvijalcem ali uporabnikom. Njeno delovanje je vredno razumeti, saj ponazarja razdelitev vlog med gostiteljem in tvojim strežnikom:
- Orodje MCP vrne plačilno sejo v
structuredContent. - Komponenta prikaže postavke, vsote, pogoje in možnosti dostave.
- Ko se uporabnik odloči za plačilo, komponenta pokliče
window.openai.requestCheckout(session); ChatGPT odpre svoj list za blagajno. - Po potrditvi ChatGPT pošlje žeton, ki predstavlja izbrani način plačila, orodju
complete_checkoutna tvojem strežniku. To orodje bremeni plačilo prek tvojega ponudnika plačilnih storitev in vrne finalizirano naročilo – rezultat, ki ga komponenta prejme kot odgovor narequestCheckout.
Seja mora vsebovati edinstven identifikator, postavke in njihove količine, vsote v manjših denarnih enotah (centi, ne decimalni evri), ponudnika plačil in metapodatke trgovca ter obvezne povezave: pogoji, zasebnost, vračila in podpora. ChatGPT doda svoja polja, kot sta merchant ali conversation_id.
Strežnik je edini vir resnice
Ne glede na tok velja ista disciplina:
- Cene in stanje naročila prihajajo s strežnika, nikoli iz vsote, izračunane v komponenti.
- Plačilni žeton se preveri, operacija je idempotentna – dvojni klik ne sme dvakrat bremeniti – naročilo se zabeleži in vrne referenčni račun.
- Preklic, zavrnitev plačila in napake ponudnika se obravnavajo v komponenti. Za list za blagajno se napaki
payment_declinedinrequires_3ds, ki ju vrnecomplete_checkout, prikažeta neposredno v listu ChatGPT.
Za list za blagajno payment_mode: "test" omogoča testiranje celotnega toka od začetka do konca s testnimi karticami brez premikanja stvarnih sredstev.
Ohrani uporabna orodja na voljo brez uporabniškega vmesnika
Kot pri preostalem delu vtičnika morata biti katalog in zmogljivosti naročanja dostopni tudi prek orodij, uporabnih brez komponente. Uporabniški vmesnik služi predstavitvi izdelkov, cen, pogojev in izbire plačila pred potrditvijo. Ne nadomešča robustnih podatkovnih orodij in nikoli ne odloča o ceni.
Ključne ugotovitve
- Vtičnik prodaja izključno fizično blago: naročnine, digitalne vsebine, krediti in nadgradnje freemium so prepovedani
- Zunanje plačilo na tvoji domeni je priporočena pot, dostopna vsem;
openExternalodpre povezavo - Shranjene načine plačila lahko ponudiš, ne pa tudi zbiraš
- List za blagajno ChatGPT (
requestCheckout+complete_checkout) je v zasebni beti, rezerviran za določene tržnice - Strežnik je edini vir resnice: izračuni cen na strani strežnika, idempotentne operacije, zneski v manjših enotah