Sprzedaż dóbr fizycznych: przepływy płatności
Na tej stronie
Lekcja przepisana 3 listopada 2026 r. na podstawie dokumentacji API Checkout, strony Dodawanie interfejsu użytkownika do serwera MCP oraz wytycznych dotyczących wtyczek od OpenAI. Poprzednia wersja omawiała sprzedaż subskrypcji i produktów cyfrowych przy użyciu wymyślonych funkcji (
defineProduct,commerceFlow) oraz struktury prowizji 30%/15% bez podania źródeł. Obecne zasady dotyczące wtyczek ograniczają handel wyłącznie do dóbr fizycznych, a dokumentacja nie wspomina o żadnych prowizjach. Źródła: Dokumentacja API Checkout · Wytyczne dotyczące wtyczek.
Co możesz sprzedawać
Zacznij od zasady, ponieważ reguluje ona wszystko inne. Zasady publikacji OpenAI są jasne: wtyczka może prowadzić handel wyłącznie dobra fizycznymi. Sprzedaż produktów cyfrowych lub usług – subskrypcji, treści cyfrowych, tokenów, kredytów – jest zabroniona, zarówno bezpośrednio, jak i pośrednio (na przykład poprzez model freemium z możliwością rozszerzenia funkcji). Obowiązuje również lista zakazanych towarów i usług (treści dla dorosłych, hazard, leki na receptę, broń, wyroby tytoniowe i nikotynowe, pirackie oprogramowanie, wprowadzające w błąd usługi finansowe i inne). Lekcja 13 ponownie porusza kwestię tego, co usługa subskrypcyjna może nadal robić w ramach tych ograniczeń.
W tych ramach OpenAI dokumentuje trzy przepływy płatności.
Przepływ 1: Płatność zewnętrzna, ścieżka domyślna
Płatność zewnętrzna to podejście zalecane i dostępne dla wszystkich. Interfejs wtyczki prezentuje dostępne produkty, na przykład za pomocą przycisku „Kup“. Gdy użytkownik zdecyduje się na zakup, interfejs przekierowuje go do tunelu płatności hostowanego na Twojej własnej domenie. Ceny, pobieranie opłat, podatki, rabaty, wysyłka, zwroty, wsparcie i zgodność z przepisami pozostają w pełni Twoją odpowiedzialnością. Po zakupie użytkownik może wrócić do ChatGPT z potwierdzeniem zamówienia lub informacją o śledzeniu przesyłki.
Aby otworzyć ten link, ChatGPT udostępnia rozszerzenie window.openai.openExternal({ href }), które otwiera kontrolowany link w przeglądarce użytkownika. Musisz zadeklarować dozwolone miejsca docelowe przekierowań w _meta["openai/widgetCSP"].redirect_domains: standardowa polityka _meta.ui.csp nie obejmuje tego przypadku. Dla zatwierdzonego miejsca docelowego ChatGPT domyślnie dodaje do adresu parametr ?redirectUrl=…; ustawienie redirectUrl: false zapobiega temu działaniu.
function openPayment(cartUrl) {
if (window.openai?.openExternal) {
window.openai.openExternal({ href: cartUrl });
} else {
// Host nie posiada tego rozszerzenia: pozwól użytkownikowi skopiować link
document.querySelector("#payment-link").textContent = cartUrl;
}
}
Zasady są specyficzne: dopóki zintegrowana płatność nie jest dostępna dla Twojej wtyczki, płatność zewnętrzna jest ścieżką obowiązkową. Żadne inne rozwiązanie płatności stron trzecich nie może być zintegrowane ani hostowane w interfejsie wtyczki.
Przepływ 2: Wcześniej zapisane metody płatności
W przypadku kwalifikujących się zakupów dóbr fizycznych interfejs może zaproponować klientowi metodę płatności, którą wcześniej u Ciebie zapisał. Użytkownik wybiera tę metodę i potwierdza zakup wewnątrz ChatGPT, bez opuszczania konwersacji. Twój serwer MCP przetwarza zamówienie i zwraca wiążące potwierdzenie. Ten przepływ może wyświetlać zapisane metody płatności, ale nie może zbierać nowych danych płatniczych.
Przepływ 3: Arkusz płatności ChatGPT (beta zamknięta)
Aby zebrać nową metodę płatności w ramach przepływu, potrzebujesz arkusza płatności ChatGPT. Ta zintegrowana funkcja płatności znajduje się w fazie beta zamkniętej, jest zarezerwowana dla określonych rynków internetowych i nie jest dostępna dla wszystkich deweloperów ani użytkowników. Warto zrozumieć jej działanie, ponieważ ilustruje ono podział ról między hostem a Twoim serwerem:
- Narzędzie MCP zwraca sesję płatności w polu
structuredContent. - Komponent wyświetla elementy, sumy, regulamin i opcje wysyłki.
- Gdy użytkownik zdecyduje się zapłacić, komponent wywołuje
window.openai.requestCheckout(session); ChatGPT otwiera swój arkusz płatności. - Po walidacji ChatGPT wysyła do narzędzia
complete_checkoutna Twoim serwerze token reprezentujący wybraną metodę płatności. Narzędzie to obciąża konto za pośrednictwem Twojego dostawcy płatności i zwraca sfinalizowane zamówienie – wynik, który komponent otrzymuje w odpowiedzi narequestCheckout.
Sesja musi zawierać unikalny identyfikator, elementy i ich ilości, sumy w jednostkach mniejszych waluty (centy, a nie euro dziesiętne), dostawcę płatności i metadane sprzedawcy oraz obowiązkowe linki: do regulaminu, polityki prywatności, zasad zwrotów i wsparcia. ChatGPT dodaje własne pola, takie jak merchant lub conversation_id.
Serwer jest źródłem prawdy
Niezależnie od przepływu obowiązują te same zasady:
- Ceny i status zamówienia pochodzą z serwera, nigdy z sumy obliczonej w komponencie.
- Token płatności jest weryfikowany, operacja jest idempotentna – podwójne kliknięcie nie może spowodować podwójnego obciążenia – zamówienie jest rejestrowane, a referencyjny paragon jest zwracany.
- Anulowanie, odmowa płatności i błędy dostawcy są obsługiwane w komponencie. W przypadku arkusza płatności błędy
payment_declinedirequires_3dszwracane przezcomplete_checkoutwyświetlają się bezpośrednio w arkuszu ChatGPT.
Dla arkusza płatności ustawienie payment_mode: "test" pozwala przetestować przepływ end-to-end przy użyciu kart testowych bez przenoszenia rzeczywistych środków.
Udostępniaj przydatne narzędzia bez interfejsu użytkownika
Podobnie jak w przypadku reszty wtyczki, katalog i możliwości składania zamówień muszą pozostać dostępne poprzez narzędzia używane bez komponentu. Interfejs użytkownika służy do prezentowania produktów, cen, warunków i wyborów płatności przed potwierdzeniem. Nie zastępuje on solidnych narzędzi danych i nigdy nie decyduje o cenie.
Kluczowe wnioski
- Wtyczka sprzedaje wyłącznie dobra fizyczne: subskrypcje, treści cyfrowe, kredyty i rozszerzenia modelu freemium są zabronione
- Płatność zewnętrzna na Twojej domenie to zalecana ścieżka dostępna dla wszystkich;
openExternalotwiera link - Można oferować zapisane metody płatności, ale nie można ich zbierać
- Arkusz płatności ChatGPT (
requestCheckout+complete_checkout) znajduje się w fazie beta zamkniętej, zarezerwowanej dla określonych rynków internetowych - Serwer jest źródłem prawdy: obliczenia cen po stronie serwera, operacje idempotentne, kwoty w jednostkach mniejszych