Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Fyysisten tuotteiden myynti: maksuvirrat

Oppitunti 7 / 14 Päivitetty 3. marraskuuta 2026 Kehittäjä
Tällä sivulla
  1. Mitä voit myydä
  2. Virta 1: Ulkoinen maksu, oletuspolku
  3. Virta 2: Aiemmin tallennetut maksutavat
  4. Virta 3: ChatGPT:n kassalomake (yksityinen beta)
  5. Palvelin on totuuden lähde
  6. Pidä hyödylliset työkalut saatavilla ilman käyttöliittymää
  7. Keskeiset asiat

Oppitunti kirjoitettu uudelleen 3. marraskuuta 2026 perustuen Checkout API -viitteeseen, Add UI to your MCP server -sivuun ja OpenAI:n Laajennusohjeisiin. Edellinen versio käsitteli tilausten ja digitaalisten tuotteiden myyntiä keksittyjen funktioiden (defineProduct, commerceFlow) ja 30 %/15 % provisiorakenteen avulla ilman lähteitä. Nykyiset laajennussäännöt rajoittavat kaupankäynnin koskemaan vain fyysisiä tuotteita, eikä dokumentaatiossa mainita provisioita. Lähteet: Checkout API reference · Plugin guidelines.

Mitä voit myydä

Aloita säännöstä, sillä se ohjaa kaikkea muuta. OpenAI:n julkaisusäännöt ovat selkeät: laajennus voi hoitaa kaupankäyntiä vain fyysisten tuotteiden osalta. Digitaalisten tuotteiden tai palveluiden – kuten tilausten, digitaalisen sisällön, tokenien tai luottojen – myynti on kiellettyä, oli se sitten suoraa tai välillistä (esimerkiksi freemium-mallin kautta tehtävä lisämyynti). Kiellettyjen tuotteiden ja palveluiden listaa sovelletaan myös (aikuisviihde, uhkapelit, reseptilääkkeet, aseet, tupakka ja nikotiini, laiton ohjelmisto, harhaanjohtavat rahoituspalvelut ja muut). Oppitunnilla 13 käydään läpi, mitä tilauspalvelu voi silti tehdä näiden rajoitusten puitteissa.

Tämän kehyksen sisällä OpenAI dokumentoi kolme maksuvirtaa.

Virta 1: Ulkoinen maksu, oletuspolku

Ulkoinen maksu on suositeltu lähestymistapa, ja se on kaikkien saatavilla. Laajennuksen käyttöliittymä esittelee kelvolliset tuotteet, esimerkiksi “Osta”-painikkeella. Kun käyttäjä päättää tehdä ostoksen, käyttöliittymä ohjaa hänet omaan verkkotunnukseesi hostattuun kassaputkeen. Hinnoittelu, keräys, verot, alennukset, toimitus, palautukset, tuki ja vaatimustenmukaisuus ovat täysin sinun vastuullasi. Ostoksen jälkeen käyttäjä voi palata ChatGPT:hen tilausvahvistuksensa tai toimitusseurannan kanssa.

Avataksesi tämän linkin ChatGPT tarjoaa laajennuksen window.openai.openExternal({ href }), joka avaa hallitun linkin käyttäjän selaimessa. Sinun on ilmoitettava sallitut uudelleenohjauskohteet kohdassa _meta["openai/widgetCSP"].redirect_domains: vakio _meta.ui.csp-käytäntö ei kata tätä tapausta. Hyväksytylle kohteelle ChatGPT lisää osoitteeseen oletusarvoisesti parametrin ?redirectUrl=…; asettamalla redirectUrl: false estät tämän.

function openPayment(cartUrl) {
  if (window.openai?.openExternal) {
    window.openai.openExternal({ href: cartUrl });
  } else {
    // Isännältä puuttuu tämä laajennus: anna käyttäjän kopioida linkki
    document.querySelector("#payment-link").textContent = cartUrl;
  }
}

Säännöt ovat tarkkoja: niin kauan kuin integroitu maksu ei ole avoinna laajennuksellesi, ulkoinen maksu on pakollinen polku. Mitään muuta kolmannen osapuolen maksuratkaisua ei saa integroida tai hostata laajennuksen käyttöliittymän sisällä.

Virta 2: Aiemmin tallennetut maksutavat

Kelpoisissa fyysisten tuotteiden ostoksissa käyttöliittymä voi tarjota asiakkaalle maksutapaa, jonka hän on jo tallentanut sinulle. Käyttäjä valitsee tämän tavan ja vahvistaa ostoksen ChatGPT:n sisällä poistumatta keskustelusta. MCP-palvelimesi käsittelee tilauksen ja palauttaa sitovan vahvistuksen. Tämä virta voi näyttää tallennetut maksutavat, mutta se ei voi kerätä uusia maksutietoja.

Virta 3: ChatGPT:n kassalomake (yksityinen beta)

Kerätäksesi uuden maksutavan virran aikana tarvitset ChatGPT:n kassalomakkeen. Tämä integroitu maksuominaisuus on yksityisessä betaversiossa, varattu tietyille markkinapaikoille, eikä se ole kaikkien kehittäjien tai käyttäjien saatavilla. Sen toimintatapa on syytä ymmärtää, koska se havainnollistaa isännän ja palvelimesi välistä roolijakoa:

  1. MCP-työkalu palauttaa maksuistunnon kohdassa structuredContent.
  2. Komponentti näyttää nimikkeet, summat, ehdot ja toimitusvaihtoehdot.
  3. Kun käyttäjä valitsee maksamisen, komponentti kutsuu funktiota window.openai.requestCheckout(session); ChatGPT avaa oman kassalomakkeensa.
  4. Vahvistuksen jälkeen ChatGPT lähettää tokenin, joka edustaa valittua maksutapaa, palvelimesi complete_checkout-työkalulle. Tämä työkalu veloittaa maksun maksuntarjoajasi kautta ja palauttaa finalisoidun tilauksen – tuloksen, jonka komponentti vastaanottaa vastauksena requestCheckout-kutsuun.

Istunnon on sisällettävä yksilöllinen tunniste, nimikkeet ja niiden määrät, summat valuutan pienimmissä yksiköissä (sentteinä, ei desimaalieuroina), maksuntarjoaja ja kauppiasmetatiedot sekä pakolliset linkit: ehdot, tietosuoja, palautukset ja tuki. ChatGPT lisää omia kenttiään, kuten merchant tai conversation_id.

Palvelin on totuuden lähde

Virrasta riippumatta sama kurinalaisuus pätee:

  • Hinnat ja tilauksen tila tulevat palvelimelta, ei koskaan komponentissa lasketusta summasta.
  • Maksutoken vahvistetaan, operaatio on idempotentti – kaksoisnapsautus ei saa veloittaa kahta kertaa – tilaus kirjataan ja viitekuitti palautetaan.
  • Peruutukset, maksun kieltäytyminen ja tarjoajan virheet käsitellään komponentissa. Kassalomakkeen osalta complete_checkout:n palauttamat virheet payment_declined ja requires_3ds näytetään suoraan ChatGPT:n lomakkeella.

Kassalomakkeen osalta payment_mode: "test" mahdollistaa end-to-end-virran testaamisen testikorteilla ilman oikeiden varojen siirtämistä.

Pidä hyödylliset työkalut saatavilla ilman käyttöliittymää

Kuten muussakin laajennuksessa, luettelo- ja tilausominaisuuksien on pysyttävä saatavilla työkalujen kautta, joita voi käyttää ilman komponenttia. Käyttöliittymä servesi tuotteiden, hintojen, ehtojen ja maksuvalintojen esittelyyn ennen vahvistusta. Se ei korvaa robusteja datatyökaluja, eikä se koskaan päätä hintaa.

Keskeiset asiat

  • Laajennus myy vain fyysisiä tuotteita: tilaukset, digitaalinen sisältö, luotot ja freemium-lisämyynti ovat kiellettyjä
  • Ulkoinen maksu omalla verkkotunnuksellasi on suositeltu ja kaikkien saatavilla oleva polku; openExternal avaa linkin
  • Tallennettuja maksutapoja voi tarjota, mutta ei kerätä
  • ChatGPT:n kassalomake (requestCheckout + complete_checkout) on yksityisessä betassa, varattu tietyille markkinapaikoille
  • Palvelin on totuuden lähde: palvelinpuolen hintalaskelmat, idempotentit operaatiot, summat pienimmissä yksiköissä