Премини към основното съдържание
Български— Изберете език
Меню

Продажба на физически стоки: платежни потоци

Урок 7 от 14 Обновен 3 ноември 2026 г. Програмист
На тази страница
  1. Какво можете да продавате
  2. Поток 1: Външно плащане, стандартният път
  3. Поток 2: Предварително запазени методи на плащане
  4. Поток 3: Листът за плащане на ChatGPT (частна бета версия)
  5. Сървърът е източникът на истината
  6. Поддържайте полезни инструменти достъпни без потребителски интерфейс
  7. Ключови изводи

Урокът е пренаписан на 3 ноември 2026 г. въз основа на Справочника за Checkout API, страницата Добавяне на потребителски интерфейс към Вашия MCP сървър и Насоките за плъгини на OpenAI. Предишната версия обхващаше продажбата на абонаменти и дигитални продукти чрез измислени функции (defineProduct, commerceFlow) и структура на комисионна от 30%/15% без източници. Текущите правила за плъгини ограничават търговията само до физически стоки, а документацията не споменава никакви комисионни. Източници: Справочник за Checkout API · Насоки за плъгини.

Какво можете да продавате

Започнете с правилото, защото то определя всичко останало. Правилата за публикуване на OpenAI са ясни: един плъгин може да извършва търговия само с физически стоки. Продажбата на дигитални продукти или услуги – абонаменти, дигитално съдържание, токени, кредити – е забранена, както директно, така и индиректно (например чрез ъпсел към Freemium модел). Прилага се и списък със забранени стоки и услуги (съдържание за възрастни, хазарт, лекарства по лекарско предписание, оръжия, тютюн и никотин, пиратски софтуер, подвеждащи финансови услуги и други). Урок 13 разглежда отново какво може да прави една абонаментна услуга в рамките на тези ограничения.

В тази рамка OpenAI документира три платежни потока.

Поток 1: Външно плащане, стандартният път

Външното плащане е препоръчителният подход и е достъпно за всички. Потребителският интерфейс на плъгина представя подходящи продукти, например с бутон “Купи”. Когато потребителят реши да направи покупка, интерфейсът го пренасочва към тунел за плащане, хостван на Вашия собствен домейн. Ценообразуването, събирането на средства, данъците, отстъпките, доставката, възстановяването на суми, поддръжката и съответствието с регулациите остават изцяло Ваша отговорност. След покупката потребителят може да се върне в ChatGPT с потвърждението за поръчката или проследяването на доставката.

За отваряне на тази връзка ChatGPT предоставя разширението window.openai.openExternal({ href }), което отваря контролирана връзка в браузъра на потребителя. Трябва да декларирате разрешените дестинации за пренасочване в _meta["openai/widgetCSP"].redirect_domains: стандартната политика _meta.ui.csp не покрива този случай. За одобрена дестинация ChatGPT добавя параметър ?redirectUrl=… към адреса по подразбиране; задаването на redirectUrl: false предотвратява това.

function openPayment(cartUrl) {
  if (window.openai?.openExternal) {
    window.openai.openExternal({ href: cartUrl });
  } else {
    // Хостът няма това разширение: позволете на потребителя да копира връзката
    document.querySelector("#payment-link").textContent = cartUrl;
  }
}

Правилата са специфични: докато интегрираното плащане не е отворено за Вашия плъгин, външното плащане е задължителният път. Никакво друго решение за плащане от трета страна не може да бъде интегрирано или хоствано в потребителския интерфейс на плъгина.

Поток 2: Предварително запазени методи на плащане

За допустими покупки на физически стоки потребителският интерфейс може да предложи на клиента метод на плащане, който вече е запазил при Вас. Потребителят избира този метод и потвърждава покупката в рамките на ChatGPT, без да напуска разговора. Вашият MCP сървър обработва поръчката и връща обвързващо потвърждение. Този поток може да показва запазени методи на плащане, но не може да събира нови платежни данни.

Поток 3: Листът за плащане на ChatGPT (частна бета версия)

За да съберете нов метод на плащане в рамките на потока, Ви е необходим листът за плащане на ChatGPT. Тази интегрирана функция за плащане е в частна бета версия, запазена за специфични пазари, и не е достъпна за всички разработчици или потребители. Нейното функциониране си заслужава да бъде разбрано, защото илюстрира разделянето на ролите между хоста и Вашия сървър:

  1. MCP инструмент връща платежна сесия в structuredContent.
  2. Компонентът показва артикули, общи суми, условия и опции за доставка.
  3. Когато потребителят избере да плати, компонентът извиква window.openai.requestCheckout(session); ChatGPT отваря своя лист за плащане.
  4. След валидиране ChatGPT изпраща токен, представляващ избрания метод на плащане, към инструмента complete_checkout на Вашия сървър. Този инструмент таксува плащането чрез Вашия доставчик на платежни услуги и връща финализираната поръчка – резултатът, който компонентът получава в отговор на requestCheckout.

Сесията трябва да съдържа уникален идентификатор, артикули и техните количества, общи суми в минорни валутни единици (центове, а не десетични евро), доставчик на плащания и метаданни на търговеца, както и задължителни връзки: условия, поверителност, възстановяване на средства и поддръжка. ChatGPT добавя свои собствени полета, като merchant или conversation_id.

Сървърът е източникът на истината

Независимо от потока, важи една и съща дисциплина:

  • Цените и статусът на поръчката идват от сървъра, никога от обща сума, изчислена в компонента.
  • Платежният токен се верифицира, операцията е идемпотентна – двойно кликване не трябва да таксува два пъти – поръчката се записва и се връща референтна разписка.
  • Отмяната, отказът на плащане и грешките на доставчика се обработват в компонента. За листа за плащане грешките payment_declined и requires_3ds, върнати от complete_checkout, се показват директно в листа на ChatGPT.

За листа за плащане payment_mode: "test" Ви позволява да тествате потока от край до край с тестови карти, без да движите реални средства.

Поддържайте полезни инструменти достъпни без потребителски интерфейс

Както при останалата част от плъгина, каталогът и възможностите за поръчване трябва да останат достъпни чрез инструменти, използваеми без компонент. Потребителският интерфейс служи за представяне на продукти, цени, условия и избор на плащане преди потвърждение. Той не замества надеждните инструменти за данни и никога не взема решения относно цената.

Ключови изводи

  • Плъгинът продава само физически стоки: абонаментите, дигиталното съдържание, кредитите и ъпселите към Freemium модели са забранени
  • Външното плащане на Вашия домейн е препоръчителният път, достъпен за всички; openExternal отваря връзката
  • Запазените методи на плащане могат да бъдат предлагани, но не и събирани
  • Листът за плащане на ChatGPT (requestCheckout + complete_checkout) е в частна бета версия, запазен за специфични пазари
  • Сървърът е източникът на истината: изчисления на цените от страна на сървъра, идемпотентни операции, суми в минорни единици