Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Pārdošana: fizisku preču maksājumu plūsmas

Nodarbība 7 no 14 Atjaunota 2026. gada 3. novembris Programmētājs
Šajā lapā
  1. Ko tu vari pārdot
  2. 1. plūsma: Ārējais maksājums – noklusējuma ceļš
  3. 2. plūsma: Iepriekš saglabātās maksājumu metodes
  4. 3. plūsma: ChatGPT norēķinu lapa (slēgta beta versija)
  5. Serveris ir patiesības avots
  6. Saglabā noderīgus rīkus pieejamus bez lietotāja saskarnes
  7. Galvenās atziņas

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:

  1. MCP rīks atgriež maksājuma sesiju laukā structuredContent.
  2. Komponents attēlo preces, kopsummas, noteikumus un piegādes opcijas.
  3. Kad lietotājs izvēlas maksāt, komponents izsauc window.openai.requestCheckout(session); ChatGPT atver savu norēķinu lapu.
  4. 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 uz requestCheckout.

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_declined un requires_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; openExternal atver 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