Pārdošana: fizisku preču maksājumu plūsmas
Šajā lapā
Nodarbība pārrakstīta 2026. gada 3. novembrī, balstoties uz Checkout API atsauces materiāliem, lapu Add UI to your MCP server un OpenAI Spraudņu vadlīnijām. Iepriekšējā versija aptvēra abonementu un digitālo produktu pārdošanu, izmantojot izgudrotas funkcijas (
defineProduct,commerceFlow) un 30%/15% komisijas struktūru bez avotiem. Pašreizējie spraudņu noteikumi komercdarbību ierobežo tikai ar fiziskām precēm, un dokumentācijā nav minētas komisijas. Avoti: Checkout API atsauce · Spraudņu vadlīnijas.
Ko tu vari pārdot
Sāc ar noteikumu, jo tas nosaka visu pārējo. OpenAI publikācijas noteikumi ir skaidri: spraudnis drīkst veikt tirdzniecību tikai ar fiziskām precēm. Digitālo produktu vai pakalpojumu – abonementu, digitālā satura, žetonu, kredītu – pārdošana ir aizliegta, gan tieši, gan netieši (piemēram, izmantojot bezmaksas versijas papildinājumu). Tiek piemērots arī aizliegto preču un pakalpojumu saraksts (pieaugušo saturam paredzēts saturs, azartspēles, recepšu zāles, ieroči, tabaka un nikotīns, pirātiska programmatūra, maldinoši finanšu pakalpojumi un citi). 13. nodarbībā vēlreiz aplūkots, ko abonementa pakalpojums šajos ierobežojumos joprojām drīkst darīt.
Šajā ietvarā OpenAI dokumentē trīs maksājumu plūsmas.
1. plūsma: Ārējais maksājums – noklusējuma ceļš
Ārējais maksājums ir ieteicamā pieeja, un tā ir pieejama visiem. Spraudņa lietotāja saskarne piedāvā atbilstošus produktus, piemēram, ar pogu “Pirkt”. Kad lietotājs nolemj veikt pirkumu, saskarne viņu novirza uz norēķinu tuneli, kas mitināts tavā domēnā. Cenu noteikšana, iekasēšana, nodokļi, atlaides, piegāde, atmaksas, atbalsts un atbilstība paliek pilnībā tavā ziņā. Pēc pirkuma lietotājs var atgriezties ChatGPT ar pasūtījuma apstiprinājumu vai piegādes izsekošanas informāciju.
Lai atvērtu šo saiti, ChatGPT nodrošina paplašinājumu window.openai.openExternal({ href }), kas lietotāja pārlūkprogrammā atver kontrolētu saiti. Tev ir jādeklarē atļautie novirzīšanas galamērķi laukā _meta["openai/widgetCSP"].redirect_domains: standarta _meta.ui.csp politika šo gadījumu neaptver. Apstiprinātam galamērķim ChatGPT pēc noklusējuma adresei pievieno parametru ?redirectUrl=…; iestatot redirectUrl: false, to var novērst.
function openPayment(cartUrl) {
if (window.openai?.openExternal) {
window.openai.openExternal({ href: cartUrl });
} else {
// Resursdatoram trūkst šī paplašinājuma: ļauj lietotājam nokopēt saiti
document.querySelector("#payment-link").textContent = cartUrl;
}
}
Noteikumi ir specifiski: kamēr integrētie maksājumi nav pieejami tavam spraudnim, ārējais maksājums ir obligātais ceļš. Spraudņa lietotāja saskarnē nevar integrēt vai mitināt nevienu citu trešās puses maksājumu risinājumu.
2. plūsma: Iepriekš saglabātās maksājumu metodes
Atbilstošiem fizisku preču pirkumiem lietotāja saskarne var piedāvāt klientam maksājuma metodi, ko tas jau ir saglabājis pie tevis. Lietotājs izvēlas šo metodi un apstiprina pirkumu ChatGPT ietvaros, neatstājot sarunu. Tavs MCP serveris apstrādā pasūtījumu un atgriež saistošu apstiprinājumu. Šī plūsma var attēlot saglabātās maksājumu metodes, taču tā nevar vākt jaunus maksājuma datus.
3. plūsma: ChatGPT norēķinu lapa (slēgta beta versija)
Lai plūsmas ietvaros vāktu jaunu maksājuma metodi, ir nepieciešama ChatGPT norēķinu lapa. Šī integrētā maksājuma funkcija ir slēgtā beta versijā, paredzēta konkrētiem tirgus laukumiem, un tā nav pieejama visiem izstrādātājiem vai lietotājiem. Ir vērts izprast tās darbību, jo tā ilustrē lomu sadalījumu starp resursdatoru un tavu serveri:
- MCP rīks atgriež maksājuma sesiju laukā
structuredContent. - Komponents attēlo preces, kopsummas, noteikumus un piegādes opcijas.
- Kad lietotājs izvēlas maksāt, komponents izsauc
window.openai.requestCheckout(session); ChatGPT atver savu norēķinu lapu. - Pēc apstiprināšanas ChatGPT nosūta tokeni, kas pārstāv izvēlēto maksājuma metodi, uz tava servera rīku
complete_checkout. Šis rīks veic iekasēšanu, izmantojot tavu maksājumu pakalpojumu sniedzēju, un atgriež pabeigto pasūtījumu – rezultātu, ko komponents saņem kā atbildi uzrequestCheckout.
Sesijai ir jābūt unikālam identifikatoram, precēm un to daudzumiem, kopsummām mazākajās valūtas vienībās (centos, nevis decimāleos eiro), maksājumu pakalpojumu sniedzēja un tirgotāja metadatiem, kā arī obligātām saitēm: noteikumi, konfidencialitāte, atmaksas un atbalsts. ChatGPT pievieno savus laukus, piemēram, merchant vai conversation_id.
Serveris ir patiesības avots
Neatkarīgi no plūsmas ir jāievēro viena un tā pati disciplīna:
- Cenas un pasūtījuma statuss nāk no servera, nekad no komponentā aprēķinātas kopsummas.
- Maksājuma tokens tiek verificēts, darbība ir idempotenta – dubultklikšķis nedrīkst izraisīt divkāršu iekasēšanu –, pasūtījums tiek reģistrēts un atgriezts atsauces kvīts.
- Atcelšana, maksājuma atteikums un pakalpojumu sniedzēja kļūdas tiek apstrādātas komponentā. Norēķinu lapai kļūdas
payment_declinedunrequires_3ds, ko atgriežcomplete_checkout, tiek attēlotas tieši ChatGPT lapā.
Norēķinu lapai payment_mode: "test" ļauj testēt darbplūsmu no gala līdz galam ar testa kartēm, nepārvietojot reālus līdzekļus.
Saglabā noderīgus rīkus pieejamus bez lietotāja saskarnes
Tāpat kā pārējā spraudņa daļā, katalogam un pasūtīšanas iespējām ir jāpaliek pieejamām, izmantojot rīkus, kurus var izmantot bez komponenta. Lietotāja saskarne kalpo, lai pirms apstiprināšanas prezentētu produktus, cenas, noteikumus un maksājuma izvēles. Tā neaizstāj robustus datu rīkus un nekad nepieņem lēmumus par cenu.
Galvenās atziņas
- Spraudnis pārdod tikai fiziskas preces: abonementi, digitālais saturs, kredīti un bezmaksas versijas papildinājumi ir aizliegti
- Ārējais maksājums tavā domēnā ir ieteicamais ceļš, kas pieejams visiem;
openExternalatver saiti - Var piedāvāt saglabātās maksājumu metodes, bet ne vākt jaunas
- ChatGPT norēķinu lapa (
requestCheckout+complete_checkout) ir slēgtā beta versijā, paredzēta konkrētiem tirgus laukumiem - Serveris ir patiesības avots: cenu aprēķini servera pusē, idempotentas darbības, summas mazākajās vienībās