Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Fizikai áruk értékesítése: fizetési folyamatok

7. lecke 14 közül Frissítve 2026. november 3. Fejlesztő
Ezen az oldalon
  1. Mit árulhatsz
  2. 1. folyamat: Külső fizetés, az alapértelmezett út
  3. 2. folyamat: Korábban elmentett fizetési módok
  4. 3. folyamat: A ChatGPT fizetési lap (zárt béta)
  5. A szerver az igazság forrása
  6. Tartsd elérhetővé a hasznos eszközöket felület nélkül
  7. Főbb megállapítások

A leckét 2026. november 3-án írtuk át a Checkout API referenciadokumentáció, az UI hozzáadása az MCP szerverhez oldal, valamint az OpenAI Bővítményekre vonatkozó irányelvei alapján. A korábbi verzió előfizetések és digitális termékek értékesítését tárgyalta kitalált függvények (defineProduct, commerceFlow) és egy 30%/15%-os jutalékszerkezet segítségével, forrásmegjelölés nélkül. A jelenlegi bővítményszabályok a kereskedelmet kizárólag fizikai árukra korlátozzák, és a dokumentáció nem említ jutalékokat. Források: Checkout API referenciadokumentáció · Bővítményekre vonatkozó irányelvek.

Mit árulhatsz

Kezdjük a szabállyal, mert ez határozza meg az összes többit. Az OpenAI közzétételi szabályai egyértelműek: egy bővítmény kizárólag fizikai áruk kereskedelmét bonyolíthatja le. Digitális termékek vagy szolgáltatások – előfizetések, digitális tartalmak, tokenek, kreditek – értékesítése tilos, akár közvetlenül, akár közvetve (például freemium modellben történő további értékesítéssel). Emellett érvényes egy tiltott áruk és szolgáltatások listája is (felnőtt tartalmak, szerencsejáték, vényköteles gyógyszerek, fegyverek, dohány és nikotin, kalóz szoftverek, megtévesztő pénzügyi szolgáltatások, és mások). A 13. lecke újra tárgyalja, mit tehet egy előfizetéses szolgáltatás ezeken a korlátokon belül.

Ezen keretrendszeren belül az OpenAI három fizetési folyamatot dokumentál.

1. folyamat: Külső fizetés, az alapértelmezett út

A külső fizetés a javasolt megközelítés, és mindenki számára elérhető. A bővítmény felülete megjeleníti a jogosult termékeket, például egy „Vásárlás“ gombbal. Amikor a felhasználó a vásárlás mellett dönt, a felület átirányítja őt a saját domaineden hosztolt fizetési alagúthoz. Az árképzés, a beszedés, az adók, a kedvezmények, a szállítás, a visszatérítések, az ügyfélszolgálat és a megfelelés teljes mértékben a te felelősséged. A vásárlás után a felhasználó visszatérhet a ChatGPT-be a rendelés megerősítésével vagy a szállítási nyomon követéssel.

Ennek a hivatkozásnak a megnyitásához a ChatGPT a window.openai.openExternal({ href }) kiterjesztést biztosítja, amely egy vezérelt hivatkozást nyit meg a felhasználó böngészőjében. Meg kell adnod az engedélyezett átirányítási célpontokat a _meta["openai/widgetCSP"].redirect_domains mezőben: a szabványos _meta.ui.csp házirend erre az esetre nem terjed ki. Egy jóváhagyott célpont esetén a ChatGPT alapértelmezés szerint egy ?redirectUrl=… paramétert fűz a címhez; a redirectUrl: false beállítása megakadályozza ezt.

function openPayment(cartUrl) {
  if (window.openai?.openExternal) {
    window.openai.openExternal({ href: cartUrl });
  } else {
    // A hoszt nem támogatja ezt a kiterjesztést: hagyd, hogy a felhasználó másolja ki a hivatkozást
    document.querySelector("#payment-link").textContent = cartUrl;
  }
}

A szabályok specifikusak: amíg az integrált fizetés nem elérhető a bővítményed számára, addig a külső fizetés a kötelező út. Más harmadik féltől származó fizetési megoldás nem integrálható vagy hosztolható a bővítmény felületén belül.

2. folyamat: Korábban elmentett fizetési módok

Fizikai áruk jogosult vásárlásai esetén a felület felajánlhatja az ügyfélnek a nálad már elmentett fizetési módot. A felhasználó kiválasztja ezt a módot, és megerősíti a vásárlást a ChatGPT-n belül, anélkül, hogy elhagyná a beszélgetést. Az MCP szervered dolgozza fel a rendelést, és visszaadja a kötelező érvényű megerősítést. Ez a folyamat megjelenítheti az elmentett fizetési módokat, de nem gyűjthet új fizetési adatokat.

3. folyamat: A ChatGPT fizetési lap (zárt béta)

Új fizetési mód gyűjtéséhez a folyamat során szükséged van a ChatGPT fizetési lapjára. Ez az integrált fizetési funkció zárt bétaverzióban érhető el, kifejezetten bizonyos piacterek számára fenntartva, és nem hozzáférhető minden fejlesztő vagy felhasználó számára. Érdemes megérteni a működését, mert szemlélteti a szerepek megosztását a hoszt és a te szervered között:

  1. Egy MCP eszköz visszaad egy fizetési munkamenetet a structuredContent elemben.
  2. A komponens megjeleníti a tételeket, az összegeket, a feltételeket és a szállítási lehetőségeket.
  3. Amikor a felhasználó a fizetés mellett dönt, a komponens meghívja a window.openai.requestCheckout(session) függvényt; a ChatGPT megnyitja a saját fizetési lapját.
  4. A jóváhagyás után a ChatGPT egy tokent küld a választott fizetési módról a szervered complete_checkout eszközének. Ez az eszköz a fizetési szolgáltatódon keresztül terheli a költséget, és visszaadja a véglegesített rendelést – ez az eredmény, amelyet a komponens kap válaszként a requestCheckout hívásra.

A munkamenetnek tartalmaznia kell egy egyedi azonosítót, a tételeket és mennyiségeiket, az összegeket pénznem legkisebb egységeiben (cent, nem tizedes euró), a fizetési szolgáltatót és a kereskedői metaadatokat, valamint a kötelező hivatkozásokat: felhasználási feltételek, adatvédelem, visszatérítések és ügyfélszolgálat. A ChatGPT hozzáadja a saját mezőit is, mint például a merchant vagy a conversation_id.

A szerver az igazság forrása

Folyamattól függetlenül ugyanaz a fegyelem érvényes:

  • Az árak és a rendelés állapota a szerverről származik, soha nem a komponensben számított összegből.
  • A fizetési tokent ellenőrizni kell, a műveletnek idempotensnek kell lennie – egy dupla kattintás nem eredményezhet dupla terhelést –, a rendelést rögzíteni kell, és egy hivatkozási nyugtát kell visszaadni.
  • A lemondást, a fizetés megtagadását és a szolgáltatói hibákat a komponens kezeli. A fizetési lap esetén a complete_checkout által visszaadott payment_declined és requires_3ds hibák közvetlenül megjelennek a ChatGPT lapon.

A fizetési lap esetén a payment_mode: "test" beállítás lehetővé teszi a végpontok közötti folyamat tesztelését tesztbankkártyákkal valódi pénz mozgatása nélkül.

Tartsd elérhetővé a hasznos eszközöket felület nélkül

A bővítmény többi részéhez hasonlóan a katalógusnak és a rendelési képességeknek komponens nélkül is elérhetőnek kell maradniuk eszközökön keresztül. A felület célja a termékek, árak, feltételek és fizetési lehetőségek bemutatása a megerősítés előtt. Nem helyettesíti a robusztus adatkezelő eszközöket, és soha nem dönt az árról.

Főbb megállapítások

  • Egy bővítmény kizárólag fizikai árukat árulhat: az előfizetések, digitális tartalmak, kreditek és a freemium további értékesítések tiltottak
  • A saját domaineden történő külső fizetés a javasolt út, amely mindenki számára elérhető; az openExternal nyitja meg a hivatkozást
  • Az elmentett fizetési módok felajánlhatók, de nem gyűjthetők
  • A ChatGPT fizetési lap (requestCheckout + complete_checkout) zárt bétaverzióban van, kifejezetten bizonyos piacterek számára fenntartva
  • A szerver az igazság forrása: szerveroldali árszámítás, idempotens műveletek, összegek a pénznem legkisebb egységeiben