Bejgħ ta' oġġetti fiżiċi: flussi ta' ħlas
F'din il-paġna
Lezzjoni miktuba mill-ġdid fit-3 ta’ Novembru 2026 abbażi tar-referenza tal-API tal-Checkout, il-paġna Żid UI mas-server MCP tiegħek, u l-linji gwida tal-Plugin ta’ OpenAI. Il-verżjoni preċedenti kopriet il-bejgħ ta’ abbonamenti u prodotti diġitali bl-użu ta’ funzjonijiet inventati (
defineProduct,commerceFlow) u struttura ta’ kummissjoni ta’ 30%/15% mingħajr sorsi. Ir-regoli attwali tal-plugin jirrestrinġu l-kummerċ għal oġġetti fiżiċi biss, u d-dokumentazzjoni ma ssemmi l-ebda kummissjoni. Sorsi: Referenza tal-API tal-Checkout · Linji gwida tal-Plugin.
X’tista’ tbigħ
Ibda bir-regola, għax hija tirregola kollox ieħor. Ir-regoli tal-pubblikazzjoni ta’ OpenAI huma ċari: plugin jista’ biss iwettaq kummerċ għal oġġetti fiżiċi. Il-bejgħ ta’ prodotti jew servizzi diġitali—abbonamenti, kontenut diġitali, tokens, krediti—huwa pprojbit, kemm jekk direttament kif ukoll indirettament (pereżempju, permezz ta’ upsell freemium). Tapplika wkoll lista ta’ oġġetti u servizzi pprojbiti (kontenut għall-adulti, logħob tal-ażżard, mediċini bir-riċetta, armi, tabakk u nikotina, softwer pirata, servizzi finanzjarji qarrieqa, fost oħrajn). Il-Lezzjoni 13 terġa’ tara x’jista’ jagħmel servizz ta’ abbonament fi ħdan dawn il-limiti.
F’dan il-qafas, OpenAI tiddokumenta tliet flussi ta’ ħlas.
Fluss 1: Ħlas estern, it-triq default
Il-ħlas estern huwa l-approċċ rakkomandat u huwa disponibbli għal kulħadd. L-UI tal-plugin tippreżenta prodotti eliġibbli, pereżempju b’buttuna “Ixtri”. Meta l-utent jiddeċiedi li jixtri, l-interfaċċa tirridirezzjonah lejn mina tal-checkpoint ospitata fuq id-dominju tiegħek stess. L-ipprezzar, il-ġbir, it-taxxi, l-iskontijiet, it-tbaħħir, ir-rimborsi, l-appoġġ u l-konformità jibqgħu kompletament ir-responsabbiltà tiegħek. Wara x-xiri, l-utent jista’ jerġa’ lura għal ChatGPT bil-konferma tal-ordni jew it-traċċar tal-konsenja tiegħu.
Biex tiftaħ din il-link, ChatGPT jipprovdi l-estensjoni window.openai.openExternal({ href }), li tiftaħ link ikkontrollat fil-browser tal-utent. Tridd tiddikjara d-destinazzjonijiet tar-ridirezzjoni permessi f’_meta[“openai/widgetCSP”].redirect_domains: il-politika standard _meta.ui.cspma tkoprix dan il-każ. Għal destinazzjoni approvata, ChatGPT iżid parametru?redirectUrl=…mal-indirizz b'mod default; li tissettjaredirectUrl: false` jipprevjeni dan.
function openPayment(cartUrl) {
if (window.openai?.openExternal) {
window.openai.openExternal({ href: cartUrl });
} else {
// L-host ma għandux din l-estensjoni: ħalli lill-utent jikkopja l-link
document.querySelector("#payment-link").textContent = cartUrl;
}
}
Ir-regoli huma speċifiċi: sakemm il-ħlas integrat ma jkunx miftuħ għall-plugin tiegħek, il-ħlas estern huwa t-triq obbligatorja. L-ebda soluzzjoni ta’ ħlas oħra ta’ parti terza ma tista’ tiġi integrata jew ospitata fl-UI tal-plugin.
Fluss 2: Metodi ta’ ħlas salvati preċedentement
Għal xirjiet eliġibbli ta’ oġġetti fiżiċi, l-UI tista’ toffri lill-klijent metodu ta’ ħlas li diġà salva miegħek. L-utent jagħżel dan il-metodu u jikkonferma x-xiri fi ħdan ChatGPT, mingħajr ma jħalli l-konversazzjoni. Is-server MCP tiegħek jipproċessa l-ordni u jirritorna l-konferma vinkolanti. Dan il-fluss jista’ juri metodi ta’ ħlas salvati, iżda ma jistax jiġbor dettalji ġodda ta’ ħlas.
Fluss 3: Is-sħaba tal-checkout ta’ ChatGPT (beta privata)
Biex tiġbor metodu ġdid ta’ ħlas fil-fluss, għandek bżonn is-sħaba tal-checkout ta’ ChatGPT. Din il-karatteristika ta’ ħlas integrata tinsab f’beta privata, riżervata għal swieq speċifiċi, u mhix aċċessibbli għall-iżviluppaturi jew l-utenti kollha. Il-funzjonament tagħha jiswa li jinftiehem għax juri d-diviżjoni tar-rwoli bejn l-host u s-server tiegħek:
- Għodda MCP tirritorna sessjoni ta’ ħlas f’
structuredContent. - Il-komponent juri l-oġġetti, it-totali, it-termini, u l-għażliet tat-tbaħħir.
- Meta l-utent jagħżel li jħallas, il-komponent isejjaħ
window.openai.requestCheckout(session); ChatGPT jiftaħ is-sħaba tal-checkout tiegħu. - Wara l-validazzjoni, ChatGPT jibgħat token li jirrappreżenta l-metodu ta’ ħlas magħżul lill-għodda
complete_checkouttas-server tiegħek. Din l-għodda timponi l-ħlas permezz tal-fornitur tal-ħlas tiegħek u tirritorna l-ordni finalizzata—ir-riżultat li l-komponent jirċievi bħala tweġiba għalrequestCheckout.
Is-sessjoni trid tkun fiha identifikatur uniku, oġġetti u l-kwantitajiet tagħhom, totali f’unitajiet żgħar tal-munita (ċenteżmi, mhux ewro deċimali), fornitur tal-ħlas u metadata tal-merċant, u links obbligatorji: termini, privatezza, rimborsi, u appoġġ. ChatGPT iżid il-qasam tiegħu stess, bħal merchant jew conversation_id.
Is-server huwa s-sors tal-verità
Irregolarment mill-fluss, tapplika l-istess dixxiplina:
- Il-prezzijiet u l-istatus tal-ordni ġejjin mis-server, qatt minn total ikkalkolat fil-komponent.
- It-token tal-ħlas jiġi vverifikat, l-operazzjoni hija idempotenti—klikk doppju m’għandux jimponi ħlas darbtejn—l-ordni tiġi rreġistrata, u tiġi rritornata riċevuta ta’ referenza.
- Il-kanċellazzjoni, iċ-ċaħda tal-ħlas, u l-iżbalji tal-fornitur jiġu ttrattati fil-komponent. Għas-sħaba tal-checkout, l-iżbalji
payment_declinedurequires_3dsirritornati minncomplete_checkoutjintwerew direttament fis-sħaba ta’ ChatGPT.
Għas-sħaba tal-checkout, payment_mode: "test" jippermettilek tittestja l-fluss minn tarf għal tarf b’kards tat-test mingħajr ma tmexxi fondi reali.
Żomm għodod utli disponibbli mingħajr UI
Bħall-bqija tal-plugin, il-katalgu u l-kapaċitajiet tal-ordnijiet iridu jibqgħu aċċessibbli permezz ta’ għodod li jistgħu jintużaw mingħajr komponent. L-UI sservi biex tippreżenta prodotti, prezzijiet, termini, u għażliet ta’ ħlas qabel il-konferma. Ma tissostitwixxix għodod robusti tad-data, u qatt ma tiddeċiedi fuq prezz.
Punti Ewlenin
- Plugin jbigħ biss oġġetti fiżiċi: abbonamenti, kontenut diġitali, krediti, u upsells freemium huma pprojbiti
- Il-ħlas estern fuq id-dominju tiegħek huwa t-triq rakkomandata disponibbli għal kulħadd;
openExternaltiftaħ il-link - Metodi ta’ ħlas salvati jistgħu jiġu offruti, mhux miġbura
- Is-sħaba tal-checkout ta’ ChatGPT (
requestCheckout+complete_checkout) tinsab f’beta privata, riżervata għal swieq speċifiċi - Is-server huwa s-sors tal-verità: kalkoli tal-prezz fuq in-naħa tas-server, operazzjonijiet idempotenti, ammonti f’unitajiet żgħar