Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Bejgħ ta' oġġetti fiżiċi: flussi ta' ħlas

Lezzjoni 7 / 14 Aġġornat 3 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. X’tista’ tbigħ
  2. Fluss 1: Ħlas estern, it-triq default
  3. Fluss 2: Metodi ta’ ħlas salvati preċedentement
  4. Fluss 3: Is-sħaba tal-checkout ta’ ChatGPT (beta privata)
  5. Is-server huwa s-sors tal-verità
  6. Żomm għodod utli disponibbli mingħajr UI
  7. Punti Ewlenin

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:

  1. Għodda MCP tirritorna sessjoni ta’ ħlas f’structuredContent.
  2. Il-komponent juri l-oġġetti, it-totali, it-termini, u l-għażliet tat-tbaħħir.
  3. Meta l-utent jagħżel li jħallas, il-komponent isejjaħ window.openai.requestCheckout(session); ChatGPT jiftaħ is-sħaba tal-checkout tiegħu.
  4. Wara l-validazzjoni, ChatGPT jibgħat token li jirrappreżenta l-metodu ta’ ħlas magħżul lill-għodda complete_checkout tas-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ħal requestCheckout.

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_declined u requires_3ds irritornati minn complete_checkout jintwerew 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; openExternal tiftaħ 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