Prodej fyzického zboží: platební toky
Na této stránce
Lekce přepracována 3. listopadu 2026 na základě Reference k Checkout API, stránky Přidání UI na váš MCP server a Pokynů pro pluginy od OpenAI. Předchozí verze pokrývala prodej předplatného a digitálních produktů pomocí vymyšlených funkcí (
defineProduct,commerceFlow) a struktury provizí 30 %/15 % bez zdrojů. Aktuální pravidla pro pluginy omezují obchodování pouze na fyzické zboží a dokumentace nezmiňuje žádné provize. Zdroje: Reference k Checkout API · Pokyny pro pluginy.
Co můžeš prodávat
Začni pravidlem, protože určuje vše ostatní. Publikační pravidla OpenAI jsou jasná: plugin může provádět obchodní transakce pouze pro fyzické zboží. Prodej digitálních produktů nebo služeb – předplatných, digitálního obsahu, tokenů, kreditů – je zakázán, ať už přímo, nebo nepřímo (například prostřednictvím upsellu ve verzi freemium). Platí také seznam zakázaného zboží a služeb (obsah pro dospělé, hazardní hry, léky na předpis, zbraně, tabák a nikotin, pirátský software, zavádějící finanční služby a další). Lekce 13 se znovu věnuje tomu, co může služba předplatného v rámci těchto limitů stále dělat.
V tomto rámci OpenAI dokumentuje tři platební toky.
Tok 1: Externí platba, výchozí cesta
Externí platba je doporučený přístup a je dostupný pro všechny. UI pluginu prezentuje způsobilé produkty, například pomocí tlačítka „Koupit“. Když se uživatel rozhodne pro nákup, rozhraní jej přesměruje na pokladní tunel hostovaný na tvé vlastní doméně. Ceny, výběr plateb, daně, slevy, doprava, reklamace, podpora a soulad s předpisy zůstávají výhradně tvou odpovědností. Po nákupu se může uživatel vrátit do ChatGPT s potvrzením objednávky nebo sledováním dodávky.
K otevření tohoto odkazu poskytuje ChatGPT rozšíření window.openai.openExternal({ href }), které otevře řízený odkaz v prohlížeči uživatele. Musíš deklarovat povolené cíle přesměrování v _meta["openai/widgetCSP"].redirect_domains: standardní politika _meta.ui.csp tento případ nepokrývá. U schváleného cíle ChatGPT ve výchozím nastavení přidá k adrese parametr ?redirectUrl=…; nastavením redirectUrl: false tomu zabráníš.
function openPayment(cartUrl) {
if (window.openai?.openExternal) {
window.openai.openExternal({ href: cartUrl });
} else {
// Hostitel toto rozšíření nemá: nech uživatele odkaz zkopírovat
document.querySelector("#payment-link").textContent = cartUrl;
}
}
Pravidla jsou specifická: dokud není integrovaná platba pro tvůj plugin otevřena, je externí platba povinnou cestou. Žádné jiné platební řešení třetí strany nelze integrovat ani hostovat v rámci UI pluginu.
Tok 2: Dříve uložené platební metody
U způsobilých nákupů fyzického zboží může UI nabídnout zákazníkovi platební metodu, kterou u tebe již uložil. Uživatel tuto metodu vybere a potvrdí nákup přímo v ChatGPT, aniž by opustil konverzaci. Tvůj MCP server zpracuje objednávku a vrátí závazné potvrzení. Tento tok může zobrazovat uložené platební metody, ale nemůže sbírat nové platební údaje.
Tok 3: Pokladní list ChatGPT (soukromá beta verze)
Chceš-li v rámci toku získat novou platební metodu, potřebuješ pokladní list ChatGPT. Tato funkce integrované platby je v soukromé beta verzi, vyhrazená pro specifická tržiště, a není dostupná všem vývojářům ani uživatelům. Její fungování stojí za pochopení, protože ilustruje rozdělení rolí mezi hostitelem a tvým serverem:
- Nástroj MCP vrátí platební relaci v
structuredContent. - Komponenta zobrazí položky, součty, podmínky a možnosti dopravy.
- Když se uživatel rozhodne zaplatit, komponenta zavolá
window.openai.requestCheckout(session); ChatGPT otevře svůj pokladní list. - Po ověření zašle ChatGPT token představující zvolenou platební metodu nástroji
complete_checkoutna tvém serveru. Tento nástroj provede účtování prostřednictvím tvého platebního poskytovatele a vrátí finalizovanou objednávku – výsledek, který komponenta obdrží jako odpověď narequestCheckout.
Relace musí obsahovat jedinečný identifikátor, položky a jejich množství, součty v menších měnových jednotkách (centy, nikoli desetinná eura), metadata poskytovatele plateb a obchodníka a povinné odkazy: podmínky, zásady ochrany osobních údajů, reklamace a podpora. ChatGPT přidává vlastní pole, jako jsou merchant nebo conversation_id.
Server je jediným zdrojem pravdy
Bez ohledu na tok platí stejná disciplína:
- Ceny a stav objednávky pocházejí ze serveru, nikdy ze součtu vypočítaného v komponentě.
- Platební token je ověřen, operace je idempotentní – dvojí kliknutí nesmí způsobit dvojí účtování – objednávka je zaznamenána a vrácen referenční doklad.
- Storno, odmítnutí platby a chyby poskytovatele jsou ošetřeny v komponentě. U pokladního listu se chyby
payment_declinedarequires_3dsvrácené nástrojemcomplete_checkoutzobrazí přímo v listu ChatGPT.
U pokladního listu umožňuje payment_mode: "test" otestovat tok end-to-end s testovacími kartami bez pohybu reálných prostředků.
Udržuj užitečné nástroje dostupné bez UI
Stejně jako u zbytku pluginu musí být katalog a možnosti objednávání přístupné prostřednictvím nástrojů použitelných bez komponenty. UI slouží k prezentaci produktů, cen, podmínek a voleb platby před potvrzením. Nenahrazuje robustní datové nástroje a nikdy nerozhoduje o ceně.
Klíčové poznatky
- Plugin prodává pouze fyzické zboží: předplatná, digitální obsah, kredity a upselly ve verzi freemium jsou zakázány
- Externí platba na tvé doméně je doporučená cesta dostupná pro všechny;
openExternalotevírá odkaz - Uložené platební metody lze nabídnout, nikoli sbírat
- Pokladní list ChatGPT (
requestCheckout+complete_checkout) je v soukromé beta verzi, vyhrazen pro specifická tržiště - Server je jediným zdrojem pravdy: výpočty cen na straně serveru, idempotentní operace, částky v menších jednotkách