Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Prodaja fizičke robe: tokovi plaćanja

Lekcija 7 od 14 Ažurirano 3. studenoga 2026. Programer
Na ovoj stranici
  1. Što možeš prodavati
  2. Tok 1: Vanjsko plaćanje, zadani put
  3. Tok 2: Prethodno spremljeni načini plaćanja
  4. Tok 3: List za naplatu u ChatGPT-u (privatna beta)
  5. Poslužitelj je izvor istine
  6. Zadrži korisne alate dostupnima bez korisničkog sučelja
  7. Ključne točke

Lekcija je ponovno napisana 3. studenog 2026. na temelju Referenci za Checkout API, stranice Dodaj korisničko sučelje svom MCP poslužitelju i OpenAIjevih Smjernica za dodatke. Prethodna verzija obrađivala je prodaju pretplata i digitalnih proizvoda koristeći izmišljene funkcije (defineProduct, commerceFlow) i strukturu provizije od 30%/15% bez izvora. Trenutna pravila za dodatke ograničavaju trgovinu isključivo na fizičku robu, a dokumentacija ne spominje nikakve provizije. Izvori: Referenca za Checkout API · Smjernice za dodatke.

Što možeš prodavati

Kreni od pravila jer ono upravlja svime ostalim. OpenAIjeva pravila objavljivanja su jasna: dodatak može obavljati trgovinu isključivo fizičkom robom. Prodaja digitalnih proizvoda ili usluga—pretplata, digitalnog sadržaja, tokena, kredita—zabranjena je, bilo izravno ili neizravno (na primjer, putem nadogradnje s besplatnog na plaćeni model). Primjenjuje se i popis zabranjene robe i usluga (sadržaj za odrasle, kockanje, lijekovi na recept, oružje, duhan i nikotin, piratski softver, zavaravajuće financijske usluge, između ostalog). Lekcija 13 ponovno razmatra što usluga pretplate još uvijek može učiniti unutar ovih ograničenja.

Unutar ovog okvira, OpenAI dokumentira tri toka plaćanja.

Tok 1: Vanjsko plaćanje, zadani put

Vanjsko plaćanje je preporučeni pristup i dostupan je svima. Korisničko sučelje dodatka prikazuje proizvode koji ispunjavaju uvjete, na primjer gumbom „Kupi“. Kada se korisnik odluči za kupnju, sučelje ga preusmjerava na tunel za naplatu hostiran na tvojoj vlastitoj domeni. Cijene, naplata, porezi, popusti, dostava, povrat novca, podrška i usklađenost u potpunosti su tvoja odgovornost. Nakon kupnje, korisnik se može vratiti u ChatGPT s potvrdom narudžbe ili praćenjem dostave.

Za otvaranje ove poveznice, ChatGPT nudi proširenje window.openai.openExternal({ href }), koje otvara kontroliranu poveznicu u korisnikovom pregledniku. Moraš deklarirati dopuštena odredišta za preusmjeravanje u _meta["openai/widgetCSP"].redirect_domains: standardna politika _meta.ui.csp ne pokriva ovaj slučaj. Za odobreno odredište, ChatGPT prema zadanim postavkama dodaje parametar ?redirectUrl=… adresu; postavljanjem redirectUrl: false to se sprječava.

function openPayment(cartUrl) {
  if (window.openai?.openExternal) {
    window.openai.openExternal({ href: cartUrl });
  } else {
    // Domaćin nema ovo proširenje: neka korisnik kopira poveznicu
    document.querySelector("#payment-link").textContent = cartUrl;
  }
}

Pravila su specifična: sve dok integrirano plaćanje nije otvoreno za tvoj dodatak, vanjsko plaćanje je obvezni put. Nije moguće integrirati niti hostirati nijedno drugo rješenje za plaćanje treće strane unutar korisničkog sučelja dodatka.

Tok 2: Prethodno spremljeni načini plaćanja

Za kvalificirane kupnje fizičke robe, korisničko sučelje može kupcu ponuditi način plaćanja koji je već spremio kod tebe. Korisnik odabire taj način i potvrđuje kupnju unutar ChatGPT-a, bez napuštanja razgovora. Tvoj MCP poslužitelj obrađuje narudžbu i vraća obvezujuću potvrdu. Ovaj tok može prikazivati spremljene načine plaćanja, ali ne može prikupljati nove podatke o plaćanju.

Tok 3: List za naplatu u ChatGPT-u (privatna beta)

Za prikupljanje novog načina plaćanja unutar toka, potreban ti je list za naplatu u ChatGPT-u. Ova značajka integriranog plaćanja nalazi se u privatnoj beti, rezervirana je za određena tržišta i nije dostupna svim programerima ni korisnicima. Njezino funkcioniranje vrijedi razumjeti jer ilustrira podjelu uloga između domaćina i tvog poslužitelja:

  1. MCP alat vraća sesiju plaćanja u structuredContent.
  2. Komponenta prikazuje stavke, ukupne iznose, uvjete i opcije dostave.
  3. Kada korisnik odabere plaćanje, komponenta poziva window.openai.requestCheckout(session); ChatGPT otvara svoj list za naplatu.
  4. Nakon validacije, ChatGPT šalje token koji predstavlja odabrani način plaćanja alatu complete_checkout na tvom poslužitelju. Ovaj alat naplaćuje putem tvog pružatelja usluga plaćanja i vraća finaliziranu narudžbu—rezultat koji komponenta prima kao odgovor na requestCheckout.

Sesija mora sadržavati jedinstveni identifikator, stavke i njihove količine, ukupne iznose u manjim jedinicama valute (centi, a ne decimalni euri), pružatelja usluga plaćanja i metapodatke trgovca, te obvezne poveznice: uvjete, privatnost, povrat novca i podršku. ChatGPT dodaje vlastita polja, poput merchant ili conversation_id.

Poslužitelj je izvor istine

Bez obzira na tok, primjenjuje se ista disciplina:

  • Cijene i status narudžbe dolaze s poslužitelja, nikada iz ukupnog iznosa izračunatog u komponenti.
  • Token za plaćanje se verificira, operacija je idempotentna—dvostruki klik ne smije naplatiti dva puta—narudžba se bilježi i vraća se referentni račun.
  • Otkazivanje, odbijanje plaćanja i pogreške pružatelja usluga obrađuju se u komponenti. Za list za naplatu, pogreške payment_declined i requires_3ds koje vrati complete_checkout prikazuju se izravno u ChatGPT listu.

Za list za naplatu, payment_mode: "test" omogućuje testiranje toka od kraja do kraja s testnim karticama bez pomicanja stvarnih sredstava.

Zadrži korisne alate dostupnima bez korisničkog sučelja

Kao i kod ostatka dodatka, katalog i mogućnosti naručivanja moraju ostati dostupne putem alata koji se mogu koristiti bez komponente. Korisničko sučelje služi za prezentaciju proizvoda, cijena, uvjeta i izbora plaćanja prije potvrde. Ono ne zamjenjuje robustne alate za podatke i nikada ne odlučuje o cijeni.

Ključne točke

  • Dodatak prodaje isključivo fizičku robu: pretplate, digitalni sadržaj, krediti i nadogradnje s besplatnog na plaćeni model zabranjeni su
  • Vanjsko plaćanje na tvojoj domeni preporučeni je put dostupan svima; openExternal otvara poveznicu
  • Spremljeni načini plaćanja mogu se ponuditi, ali ne i prikupljati
  • ChatGPT list za naplatu (requestCheckout + complete_checkout) u privatnoj je beti, rezerviran za određena tržišta
  • Poslužitelj je izvor istine: izračuni cijena na strani poslužitelja, idempotentne operacije, iznosi u manjim jedinicama