Fizinių prekių pardavimas: mokėjimų srautai
Šiame puslapyje
Pamoka perrašyta 2026 m. lapkričio 3 d. remiantis Checkout API nuoroda, puslapiu Add UI to your MCP server ir OpenAI Papildinių gairėmis. Ankstesnė versija apėmė prenumeratų ir skaitmeninių produktų pardavimą naudojant išgalvotas funkcijas (
defineProduct,commerceFlow) ir 30 %/15 % komisinių struktūrą be šaltinių. Dabartinės papildinių taisyklės leidžia komerciją vykdyti tik fizinėms prekėms, o dokumentacijoje komisinių neminama. Šaltiniai: Checkout API nuoroda · Papildinių gairės.
Ką gali parduoti
Pradėkime nuo taisyklės, nes ji lemia visa kita. OpenAI publikavimo taisyklės yra aiškios: papildinys gali vykdyti komerciją tik fizinėms prekėms. Skaitmeninių produktų ar paslaugų – prenumeratų, skaitmeninio turinio, žetonų, kreditų – pardavimas yra draudžiamas, tiesiogiai ar netiesiogiai (pavyzdžiui, per „freemium“ modelio papildomus pasiūlymus). Taip pat taikomas draudžiamų prekių ir paslaugų sąrašas (suaugusiems skirtas turinys, lošimai, receptiniai vaistai, ginklai, tabakas ir nikotinas, piratinė programinė įranga, klaidinančios finansinės paslaugos ir kt.). 13 pamokoje dar kartą aptarsime, ką prenumeratos paslauga vis dar gali daryti laikydamasi šių ribojimų.
Šiose ribose OpenAI dokumentuoja tris mokėjimų srautus.
1 srautas: Išorinis mokėjimas – numatytasis kelias
Išorinis mokėjimas yra rekomenduojamas būdas ir yra prieinamas visiems. Papildinio sąsaja pateikia tinkamus produktus, pavyzdžiui, su mygtuku „Pirkti“. Kai vartotojas nusprendžia pirkti, sąsaja nukreipia jį į jūsų domene talpinamą atsiskaitymo tunelį. Kainodara, surinkimas, mokesčiai, nuolaidos, siuntimas, grąžinimas, palaikymas ir atitiktis reikalavimams lieka visiškai jūsų atsakomybe. Po pirkimo vartotojas gali grįžti į ChatGPT su užsakymo patvirtinimu arba siuntos sekimo informacija.
Norint atidaryti šią nuorodą, ChatGPT suteikia plėtinį window.openai.openExternal({ href }), kuris atidaro valdomą nuorodą vartotojo naršyklėje. Turite deklaruoti leidžiamas nukreipimo paskirties vietas _meta["openai/widgetCSP"].redirect_domains: standartinė _meta.ui.csp politika šio atvejo neapima. Patvirtintai paskirties vietai ChatGPT pagal nutylėjimą prie adreso prideda parametrą ?redirectUrl=…; nustatant redirectUrl: false, to išvengiama.
function openPayment(cartUrl) {
if (window.openai?.openExternal) {
window.openai.openExternal({ href: cartUrl });
} else {
// Hostas neturi šio plėtinio: leiskite vartotojui nukopijuoti nuorodą
document.querySelector("#payment-link").textContent = cartUrl;
}
}
Taisyklės yra specifinės: kol integruotas mokėjimas nėra atviras jūsų papildiniui, išorinis mokėjimas yra privalomas kelias. Jokia kita trečiosios šalies mokėjimo sistema negali būti integruota ar talpinama papildinio sąsajoje.
2 srautas: Anksčiau išsaugoti mokėjimo būdai
Tinkamiems fizinių prekių pirkimams sąsaja gali pasiūlyti klientui jau pas jus išsaugotą mokėjimo būdą. Vartotojas pasirenka šį būdą ir patvirtina pirkimą tiesiogiai ChatGPT, neišeidamas iš pokalbio. Jūsų MCP serveris apdoroja užsakymą ir grąžina įpareigojantį patvirtinimą. Šis srautas gali rodyti išsaugotus mokėjimo būdus, tačiau negali rinkti naujų mokėjimo duomenų.
3 srautas: ChatGPT atsiskaitymo lapas (uždaras beta testavimas)
Norint srauto metu surinkti naują mokėjimo būdą, reikia ChatGPT atsiskaitymo lapo. Ši integruota mokėjimo funkcija yra uždarame beta teste, skirta specifinėms prekyvietėms, ir nėra prieinama visiems kūrėjams ar vartotojams. Verta suprasti jos veikimą, nes ji iliustruoja vaidmenų pasiskirstymą tarp hosto ir jūsų serverio:
- MCP įrankis grąžina mokėjimo sesiją lauke
structuredContent. - Komponentas rodo prekes, sumas, sąlygas ir siuntimo parinktis.
- Kai vartotojas pasirenka mokėti, komponentas iškviečia
window.openai.requestCheckout(session); ChatGPT atidaro savo atsiskaitymo lapą. - Po patvirtinimo ChatGPT siunčia žetoną, reprezentuojantį pasirinktą mokėjimo būdą, į jūsų serverio įrankį
complete_checkout. Šis įrankis nuskaito lėšas per jūsų mokėjimų teikėją ir grąžina finalizuotą užsakymą – tai rezultatas, kurį komponentas gauna kaip atsakymą įrequestCheckout.
Sesijoje turi būti unikalus identifikatorius, prekės ir jų kiekiai, sumos mažiausiais valiutos vienetais (centais, o ne dešimtainiais eurais), mokėjimų teikėjo ir prekybininko metaduomenys bei privalomos nuorodos: sąlygos, privatumas, grąžinimas ir palaikymas. ChatGPT priduria savo laukus, pavyzdžiui, merchant arba conversation_id.
Serveris yra tiesos šaltinis
Nepriklausomai nuo srauto, taikoma ta pati disciplina:
- Kainos ir užsakymo būsena gaunamos iš serverio, niekada iš komponente apskaičiuotos sumos.
- Mokėjimo žetonas patikrinamas, operacija yra idempotentinė – dvigubas spustelėjimas neturi dukart nuskaičiuoti lėšų – užsakymas įrašomas ir grąžinamas etaloninis kvitas.
- Atšaukimas, mokėjimo atsisakymas ir teikėjo klaidos apdorojamos komponente. Atsiskaitymo lapui klaidos
payment_declinedirrequires_3ds, grąžintos išcomplete_checkout, rodomos tiesiogiai ChatGPT lape.
Atsiskaitymo lapui payment_mode: "test" leidžia testuoti visą srautą su testinėmis kortelėmis neperkeliant realių lėšų.
Išlaikykite naudingus įrankius prieinamus be sąsajos
Kaip ir likusioje papildinio dalyje, katalogo ir užsakymų galimybės turi išlikti prieinamos per įrankius, naudojamus be komponento. Sąsaja skirta pateikti produktus, kainas, sąlygas ir mokėjimo pasirinkimus prieš patvirtinimą. Ji nepakeičia patikimų duomenų įrankių ir niekada nepriima sprendimų dėl kainos.
Svarbiausi punktai
- Papildinys parduoda tik fizines prekes: prenumeratos, skaitmeninis turinys, kreditai ir „freemium“ papildomi pasiūlymai yra draudžiami
- Išorinis mokėjimas jūsų domene yra rekomenduojamas kelias, prieinamas visiems;
openExternalatidaro nuorodą - Galima pasiūlyti išsaugotus mokėjimo būdus, bet jų negalima rinkti
- ChatGPT atsiskaitymo lapas (
requestCheckout+complete_checkout) yra uždarame beta teste, skirtas specifinėms prekyvietėms - Serveris yra tiesos šaltinis: kainų skaičiavimas serveryje, idempotentinės operacijos, sumos mažiausiais vienetais