Salt la conținutul principal
Română— Alege o limbă
Meniu

Vânzarea de bunuri fizice: fluxuri de plată

Lecția 7 din 14 Actualizată 3 noiembrie 2026 Dezvoltator
Pe această pagină
  1. Ce puteți vinde
  2. Fluxul 1: Plata externă, calea implicită
  3. Fluxul 2: Metode de plată salvate anterior
  4. Fluxul 3: Foaia de checkout ChatGPT (beta privată)
  5. Serverul este sursa adevărului
  6. Mențineți instrumentele utile disponibile fără o interfață grafică
  7. Puncte cheie

Lecție rescrisă la 3 noiembrie 2026 pe baza referinței API Checkout, a paginii Adăugarea interfeței utilizator la serverul MCP și a ghidurilor pentru pluginuri OpenAI. Versiunea anterioară acoperea vânzarea de abonamente și produse digitale folosind funcții inventate (defineProduct, commerceFlow) și o structură de comision de 30%/15% fără surse. Regulile actuale pentru pluginuri restricționează comerțul exclusiv la bunuri fizice, iar documentația nu menționează niciun comision. Surse: Referința API Checkout · Ghiduri pentru pluginuri.

Ce puteți vinde

Începeți cu regula, deoarece aceasta guvernează totul restul. Regulile de publicare OpenAI sunt clare: un plugin poate efectua tranzacții comerciale doar pentru bunuri fizice. Vânzarea de produse digitale sau servicii—abonamente, conținut digital, token-uri, credite—este interzisă, fie direct, fie indirect (de exemplu, prin upsell freemium). Se aplică, de asemenea, o listă de bunuri și servicii interzise (conținut pentru adulți, jocuri de noroc, medicamente pe bază de rețetă, arme, tutun și nicotină, software piratat, servicii financiare înșelătoare, printre altele). Lecția 13 revine asupra a ceea ce poate face totuși un serviciu de abonament în aceste limite.

În acest cadru, OpenAI documentează trei fluxuri de plată.

Fluxul 1: Plata externă, calea implicită

Plata externă este abordarea recomandată și este disponibilă pentru toată lumea. Interfața utilizator a pluginului prezintă produsele eligibile, de exemplu cu un buton „Cumpărați“. Când utilizatorul decide să facă o achiziție, interfața îl redirecționează către un tunel de checkout găzduit pe propriul dumneavoastră domeniu. Prețurile, colectarea, taxele, reducerile, livrarea, rambursările, suportul și conformitatea rămân în întregime responsabilitatea dumneavoastră. După achiziție, utilizatorul se poate întoarce în ChatGPT cu confirmarea comenzii sau cu urmărirea livrării.

Pentru a deschide acest link, ChatGPT pune la dispoziție extensia window.openai.openExternal({ href }), care deschide un link controlat în browserul utilizatorului. Trebuie să declarați destinațiile de redirecționare permise în _meta["openai/widgetCSP"].redirect_domains: politica standard _meta.ui.csp nu acoperă acest caz. Pentru o destinație aprobată, ChatGPT adaugă implicit un parametru ?redirectUrl=… la adresă; setarea redirectUrl: false previne acest lucru.

function openPayment(cartUrl) {
  if (window.openai?.openExternal) {
    window.openai.openExternal({ href: cartUrl });
  } else {
    // Gazda nu are această extensie: permiteți utilizatorului să copieze linkul
    document.querySelector("#payment-link").textContent = cartUrl;
  }
}

Regulile sunt specifice: atâta timp cât plata integrată nu este deschisă pentru pluginul dumneavoastră, plata externă este calea obligatorie. Nicio altă soluție de plată terță nu poate fi integrată sau găzduită în interfața utilizator a pluginului.

Fluxul 2: Metode de plată salvate anterior

Pentru achizițiile eligibile de bunuri fizice, interfața utilizator poate oferi clientului o metodă de plată pe care a salvat-o deja la dumneavoastră. Utilizatorul selectează această metodă și confirmă achiziția în interiorul ChatGPT, fără a părăsi conversația. Serverul dumneavoastră MCP procesează comanda și returnează confirmarea obligatorie. Acest flux poate afișa metodele de plată salvate, dar nu poate colecta noi detalii de plată.

Fluxul 3: Foaia de checkout ChatGPT (beta privată)

Pentru a colecta o nouă metodă de plată în cadrul fluxului, aveți nevoie de foaia de checkout ChatGPT. Această funcție de plată integrată se află în beta privată, rezervată unor piețe specifice, și nu este accesibilă tuturor dezvoltatorilor sau utilizatorilor. Funcționarea sa merită înțeleasă deoarece ilustrează diviziunea rolurilor dintre gazdă și serverul dumneavoastră:

  1. Un instrument MCP returnează o sesiune de plată în structuredContent.
  2. Componenta afișează articolele, totalurile, termenii și opțiunile de livrare.
  3. Când utilizatorul alege să plătească, componenta apelează window.openai.requestCheckout(session); ChatGPT deschide foaia sa de checkout.
  4. După validare, ChatGPT trimite un token care reprezintă metoda de plată aleasă către instrumentul complete_checkout al serverului dumneavoastră. Acest instrument taxează prin intermediul furnizorului dumneavoastră de plăți și returnează comanda finalizată—rezultatul pe care componenta îl primește ca răspuns la requestCheckout.

Sesiunea trebuie să conțină un identificator unic, articolele și cantitățile lor, totalurile în unități monetare minore (cenți, nu euro zecimali), furnizorul de plăți și metadatele comerciantului, precum și linkuri obligatorii: termeni, confidențialitate, rambursări și suport. ChatGPT adaugă propriile câmpuri, cum ar fi merchant sau conversation_id.

Serverul este sursa adevărului

Indiferent de flux, se aplică aceeași disciplină:

  • Prețurile și starea comenzii provin de la server, niciodată dintr-un total calculat în componentă.
  • Tokenul de plată este verificat, operațiunea este idempotentă—un dublu clic nu trebuie să taxeze de două ori—comanda este înregistrată, iar o chitanță de referință este returnată.
  • Anularea, refuzul plății și erorile furnizorului sunt gestionate în componentă. Pentru foaia de checkout, erorile payment_declined și requires_3ds returnate de complete_checkout se afișează direct în foaia ChatGPT.

Pentru foaia de checkout, payment_mode: "test" vă permite să testați fluxul cap-la-cap cu carduri de test fără a muta fonduri reale.

Mențineți instrumentele utile disponibile fără o interfață grafică

Ca și în restul pluginului, catalogul și capacitățile de comandă trebuie să rămână accesibile prin instrumente utilizabile fără o componentă. Interfața utilizator servește la prezentarea produselor, prețurilor, termenilor și opțiunilor de plată înainte de confirmare. Aceasta nu înlocuiește instrumentele robuste de date și nu decide niciodată asupra unui preț.

Puncte cheie

  • Un plugin vinde doar bunuri fizice: abonamentele, conținutul digital, creditele și upsell-urile freemium sunt interzise
  • Plata externă pe domeniul dumneavoastră este calea recomandată disponibilă pentru toată lumea; openExternal deschide linkul
  • Metodele de plată salvate pot fi oferite, nu colectate
  • Foaia de checkout ChatGPT (requestCheckout + complete_checkout) este în beta privată, rezervată unor piețe specifice
  • Serverul este sursa adevărului: calculele prețurilor pe server, operațiuni idempotente, sume în unități minore