Füüsiliste kaupade müük: maksevoogude juhend
Sellel lehel
Õppetund kirjutati 3. novembril 2026 ümber, tuginedes Checkout API referentsile, lehele Add UI to your MCP server ja OpenAI pistikprogrammide juhistele. Eelmine versioon käsitles tellimuste ja digitaalsete toodete müüki väljamõeldud funktsioonide (
defineProduct,commerceFlow) ja 30%/15% komisjonitasu struktuuri abil, millel puudusid allikad. Praegused pistikprogrammide reeglid piiravad kaubanduse üksnes füüsiliste kaupadega ning dokumentatsioonis ei mainita komisjonitasusid. Allikad: Checkout API referents · Pistikprogrammide juhised.
Mida sa tohid müüa
Alusta reeglist, sest see määrab kõik muu. OpenAI avaldamise reeglid on selged: pistikprogramm võib tegeleda kaubandusega üksnes füüsiliste kaupade puhul. Digitaalsete toodete või teenuste – nagu tellimused, digisisu, tokenid või krediidid – müük on keelatud, olgu see siis otsene või kaudne (näiteks freemium-mudeli kaudu lisamüügina). Samuti kehtib keelatud kaupade ja teenuste nimekiri (täiskasvanutele mõeldud sisu, hasartmängud, retseptiravimid, relvad, tubakas ja nikotiin, piraattarkvara, eksitavad finantsteenused jt). 13. õppetunnis vaatleme uuesti, mida saab tellimusteenuse raames nende piirangute piires teha.
Selles raamistikus kirjeldab OpenAI kolme maksevoogu.
Voog 1: Väline makse – vaikimisi tee
Väline makse on soovitatav lähenemine ja see on kättesaadav kõigile. Pistikprogrammi kasutajaliides esitab sobivad tooted, näiteks „Osta“ nupuga. Kui kasutaja otsustab ostu sooritada, suunab liides ta sinu enda domeenil majutatud makselehele. Hinnakujundus, kogumine, maksud, soodustused, tarne, tagastused, tugi ja vastavus jäävad täielikult sinu vastutusele. Pärast ostu saab kasutaja naasta ChatGPT-sse oma tellimuse kinnituse või tarne jälgimisega.
Selle lingi avamiseks pakub ChatGPT laiendust window.openai.openExternal({ href }), mis avab kontrollitud lingi kasutaja brauseris. Sa pead lubatud ümbersuunamissihtkohad deklareerima võtmes _meta["openai/widgetCSP"].redirect_domains: standardne _meta.ui.csp poliitika seda juhtu ei hõlma. Heakskiidetud sihtkoha korral lisab ChatGPT aadressile vaikimisi parameetri ?redirectUrl=…; selle vältimiseks määra redirectUrl: false.
function openPayment(cartUrl) {
if (window.openai?.openExternal) {
window.openai.openExternal({ href: cartUrl });
} else {
// Hostil puudub see laiendus: lase kasutajal link kopeerida
document.querySelector("#payment-link").textContent = cartUrl;
}
}
Reeglid on konkreetsed: seni kuni integreeritud makse pole sinu pistikprogrammi jaoks avatud, on väline makse kohustuslik tee. Ühtegi teist kolmanda osapoole makselahendust ei tohi pistikprogrammi kasutajaliidesesse integreerida ega seal majutada.
Voog 2: Varem salvestatud makseviisid
Füüsiliste kaupade sobivate ostude korral võib kasutajaliides pakkuda kliendile makseviisi, mille ta on sinu juures varem salvestanud. Kasutaja valib selle meetodi ja kinnitab ostu ChatGPT-s, vestlusest lahkumata. Sinu MCP-server töötleb tellimuse ja tagastab siduva kinnituse. See voog võib salvestatud makseviise kuvada, kuid ei tohi uusi makseandmeid koguda.
Voog 3: ChatGPT makseleht (suletud beetaversioon)
Uue makseviisi kogumiseks voo raames on vaja ChatGPT makselehte. See integreeritud maksefunktsioon on suletud beetaversioonis, reserveeritud kindlatele turuplatsidele ega ole kättesaadav kõigile arendajatele ega kasutajatele. Selle toimimist tasub mõista, kuna see illustreerib hosti ja sinu serveri rollide jaotust:
- MCP-tööriist tagastab maksesessiooni väljal
structuredContent. - Komponent kuvab kaubad, summad, tingimused ja tarnevõimalused.
- Kui kasutaja otsustab maksta, kutsub komponent
window.openai.requestCheckout(session); ChatGPT avab oma makselehe. - Pärast kinnitamist saadab ChatGPT sinu serveri tööriistale
complete_checkouttokeni, mis esindab valitud makseviisi. See tööriist teeb makse sinu makseteenuse pakkuja kaudu ja tagastab lõpliku tellimuse – tulemuse, mille komponent saab vastuseksrequestCheckoutväljakutsele.
Sessioon peab sisaldama unikaalset identifikaatorit, kaupu ja nende koguseid, summasid väiksemates valuutaühikutes (sendid, mitte kümnendmurdudes eurod), makseteenuse pakkuja ja kaupmehe metaandmeid ning kohustuslikke linke: tingimused, privaatsus, tagastused ja tugi. ChatGPT lisab oma väljad, nagu merchant või conversation_id.
Server on tõese allikas
Sõltumata voost kehtib sama distsipliin:
- Hinnad ja tellimuse staatus pärinevad serverist, mitte kunagi komponendis arvutatud summast.
- Maksetokenit kontrollitakse, toiming on idempotentne – topeltklõps ei tohi põhjustada topeltarvet –, tellimus salvestatakse ja tagastatakse viitena kviitung.
- Tühistamine, makse keeldumine ja teenusepakkuja vead käsitletakse komponendis. Makselehe puhul kuvatakse
complete_checkoutpoolt tagastatud veadpayment_declinedjarequires_3dsotse ChatGPT lehel.
Makselehe puhul võimaldab payment_mode: "test" testida kogu voogu testkaartidega, liigutamata reaalseid vahendeid.
Hoia kasulikud tööriistad ilma kasutajaliideseta kättesaadavana
Nagu ülejäänud pistikprogrammi puhul, peavad kataloog ja tellimisvõimalused jääma kättesaadavaks tööriistade kaudu, mida saab kasutada ilma komponendita. Kasutajaliides teenib eesmärki esitleda tooteid, hindu, tingimusi ja maksevalikuid enne kinnitamist. See ei asenda töökindlaid andmetööriistu ega otsusta kunagi hinna üle.
Peamised punktid
- Pistikprogramm müüb ainult füüsilisi kaupu: tellimused, digisisu, krediidid ja freemium-lisamüük on keelatud
- Väline makse sinu domeenil on soovitatud tee, mis on kõigile kättesaadav;
openExternalavab lingi - Salvestatud makseviise saab pakkuda, kuid mitte koguda
- ChatGPT makseleht (
requestCheckout+complete_checkout) on suletud beetaversioonis ja reserveeritud kindlatele turuplatsidele - Server on tõese allikas: hinnakalkulatsioon serveripoolselt, idempotentsed toimingud, summad väiksemates ühikutes