ChatGPT Merchants və satıcının yolu: qeydiyyatdan məsuliyyətə qədər

1. ChatGPT‑satıcısı kimdir və o, “adi mağazadan” nə ilə fərqlənir

İnkişaf etdiricinin gözü ilə baxsaq, səviyyələri qarışdırmaq çox asandır: bizdə Next.js‑tətbiqi, MCP‑serveri, hansısa commerce‑backend və haradasa OpenAI, ChatGPT, Stripe və digər “böyük” servislər var. Demək istəyirsən: “Bunların hamısı bir böyük sistemdir, əsas odur ki, testlər yaşıl olsun”.

Amma AI‑commerce dünyasında hüquqi və texniki sərhədlər çox sərt ayrılıb. ChatGPT nə sizin mağazanız olur, nə də ödəniş prosessoruna çevrilir. O, sadəcə ağıllı interfeys təqdim edir və açıq spesifikasiyalar üzrə sizin API‑lərinizi çağırır. Satıcı isə konkret kataloqu və istifadəçi qarşısında məsuliyyəti olan konkret şirkət olaraq qalır.

Satıcının rolunu anlamaq təkcə hüquqşünaslar üçün deyil. Ondan memarlıq qərarları asılıdır: feed məlumatları harada saxlanılır, sifarişləri necə yoxlayırsınız, nəyi loglayırsınız, çatda göstərilənlə sizin sisteminizdə həqiqətən baş verənlər arasındakı uyğunsuzluqları necə sazlayırsınız.

Nümunə

Klassik e‑commerce təsəvvür edək: sizdə sayt, səbət, checkout, ödəniş provayderi ilə inteqrasiya var. İstifadəçi brauzerdən daxil olur, siçanla klikləyir, kart məlumatlarını daxil edir — hər şey aydındır.

ChatGPT‑satıcısı — eyni mağazadır, sadəcə yüksək avtomatlaşdırma ilə AI‑dialoq vasitəsilə satmağı öyrənib. Fərq nəyi satmağınızda deyil, istifadəçinin sorğudan ödənişə qədər yolu necə keçməyindədir.

OpenAI baxımından satıcı — bu təşkilatdır (və ya fərdi sahibkar), hansı ki:

• OpenAI spesifikasiyasına uyğun Product Feed təqdim edir (SKU barədə strukturlu məlumatlarla CSV/TSV/XML/JSON);
• ChatGPT Merchants portalında qeydiyyatdan keçir və kateqoriya və hüquqi tələblərin yoxlanışından keçir;
• inkişaf etmiş variantda Agentic Checkout və Delegated Payment reallaşdırır ki, ChatGPT‑də Instant Checkout saytdan çıxmadan ödənişi həyata keçirə bilsin.

Yəni satıcı — “widget yazmış insan” deyil, assortimentin və maliyyə öhdəliklərinin sahibidir. Kursumuzda biz iki rolu bir yerdə oynayırıq: həm ChatGPT App kimi GiftGenius yazan komanda, həm də bu App‑i xidmət göstərən satıcının backend‑ini quran komanda.

2. ChatGPT Merchants portalı: müraciətdən production üçün hazır satıcıya

OpenAI‑ın satıcılar üçün ayrıca saytı var — portal ChatGPT Merchants. Onun vasitəsilə satıcılar Instant Checkout proqramına düşür və öz feed və backend‑lərini qoşurlar. Bu yolu addım‑addım, hələ ki, dərin texniki detallara girmədən (bu, növbəti mühazirədə olacaq) nəzərdən keçirək.

Ön hazırlıq

Komandanızdan kimsə “Apply” düyməsini basmazdan əvvəl sizdə artıq bir neçə “kərpic” olmalıdır:

Hüquqi şəxs və sayt. Satıcının domeni və istifadəçi üçün aydın storefront‑u (vitrini) olmalıdır — hətta sonra hər şey ChatGPT vasitəsilə satılacaqsa belə, OpenAI ictimai vitrin gözləyir.

Siyasət daxilində assortiment. Keçən mühazirədə Prohibited Products Policy‑dən danışmışdıq: məsələn, silah və bəzi tibbi məhsullar olmaz. ChatGPT vasitəsilə satmaq istədiyiniz hər bir məhsul icazə verilən kateqoriyalara sığmalıdır.

Əsas ödəniş infrastrukturu. Delegated Payment sizi kartlarla birbaşa işləməkdən azad etsə də, sizdə mütləq PSP (məsələn, Stripe) ilə inteqrasiya və sisteminizdə sifariş və geri qaytarmaları necə yaraddığınız barədə anlayış olmalıdır.

Merchants portalında müraciət

Texniki baxımdan bu kifayət qədər darıxdırıcı, amma vacib addımdır: sayta daxil olub Instant Checkout proqramında iştirak üçün müraciət göndərirsiniz. Adətən soruşurlar:

• siz kimsiniz (hüquqi şəxs, sayt, əlaqələr);
• nə satırsınız (kateqoriyalar, qiymət diapazonu, regionlar);
• Product Feed‑i necə təqdim etməyə hazırsınız (format, URL, yenilənmə dövriliyi).

Bu hissə TypeScript ilə az əlaqəlidir, amma sizin roadmap‑ə güclü təsir edir: satıcı baza yoxlamadan keçməyincə, kodunuz ideal olsa belə, heç bir Instant Checkout aktivləşdirilməyəcək.

Product Feed qoşulması

Müraciətə baxıldıqdan və ümumən razı olunduqdan sonra əsas texniki fokus Product Feed‑ə keçir. Sənədlərə görə feed inteqrasiya üçün məcburidir: onsuz ChatGPT nə satdığınızı bilmir.

Bu addımda siz:

1. Feed formatını müəyyənləşdirirsiniz (ən çox CSV və ya JSON).
2. Onu necə təqdim edəcəyiniz barədə razılaşırsınız: bu, S3‑də pre‑signed URL və ya siz vaxtaşırı yeniləmələri POST etdiyiniz HTTPS‑endpoint ola bilər.
3. Hər SKU üçün minimum sahələri hazırlayırsınız: id, title, description, price, currency, availability, link, şəkillər və flaqlar enable_search / enable_checkout.

Siz enable_checkout = false qoyduğunuz müddətdə satıcı discovery‑only rejimində işləyə bilər: ChatGPT məhsulları tapır və tövsiyə edir, amma almağa cəhd zamanı istifadəçini sizin sayta yönləndirir.

ACP inteqrasiyası (ətraflı növbəti mühazirədə)

Product Feed sabitləşəndə və növbəti mərhələyə hazır olanda Agentic Checkout və Delegated Payment inteqrasiyası başlayır. Merchants portalı baxımından bu ayrıca tələblər blokudur: siz /checkout_sessions endpointlərini reallaşdırmalı, delegated ödəniş tokenini (Shared Payment Token) qəbul etməyi öyrənməli və sessiyaları lazım olan statuslarla düzgün tamamlamalısınız (not_ready_for_payment, ready_for_payment, completed, canceled).

Bu mühazirədə biz bunu “növbəti çətinlik səviyyəsi” kimi sadəcə qeyd edirik. Protokolun bütün detalları və sorğu sxemlərini növbəti mühazirədə açacağıq.

3.5. Sertifikatlaşdırma və Instant Checkout‑un aktivləşdirilməsi

Son mərhələ — backend‑inizin real ssenarilərdə özünü necə apardığının yoxlanması:

• sifarişlər düzgün yaradılırmı;
• feed‑dəki qiymətlər pulları həqiqətən hansı qiymətə tutduğunuzla üst‑üstə düşürmü;
• səhvlər və geri qaytarmalar düzgün emal olunurmu;
• ToS/Privacy səhifələriniz OpenAI və yerli hüququn gözləntilərinə uyğundurmu.

Bundan sonra satıcı “Instant Checkout‑a hazırdır” statusu alır və enable_checkout = true olan məhsulları birbaşa ChatGPT‑də həqiqətən alına bilən olur.

Bütün bunları sadə diaqram şəklində təsəvvür etmək olar:

flowchart TD
  A[Məhsul və sayt var] --> B[ChatGPT Merchants-ə müraciət]
  B --> C[Product Feed qoşulub]
  C --> D["ACP backend reallaşdırılıb
(checkout_sessions + delegated payment)"]
  D --> E[Sertifikatlaşdırma
və Instant Checkout-un aktivləşdirilməsi]

3. Satıcı variantları: Etsy/Shopify vs xüsusi backend

Yaxşı xəbər: bütün satıcılar ACP backend‑ini özləri yazmağa məcbur deyil. Bəzi platformalar (Shopify, Etsy və s.) üçün texniki reallaşdırmanı öz üzərinə götürən inteqrasiyalar artıq mövcuddur.

Shopify və ya Etsy ilə satırsınızsa, sxem təxminən belədir: onlarda “Show in ChatGPT” kimi bir opsiyanı aktivləşdirirsiniz və platforma özü:

• lazımi formatda Product Feed formalaşdırır və dəstəkləyir;
• ACP endpointlərini reallaşdırır və ya proxy edir;
• Stripe və ya başqa PSP ilə tutuşdurur.

Siz, mağaza sahibi kimi, REST‑endpointlərdən çox assortiment və təsvirlərlə məşğul olursunuz.

Əgər bizim kursdakı GiftGenius‑da olduğu kimi, xüsusi backend‑i olan öz satıcınızı qurursunuzsa, sizdə həm daha çox azadlıq, həm də daha çox iş var: feed, checkout və ödəniş provayderi ilə inteqrasiyanı reallaşdıran kodu özünüz yazırsınız.

Bunu cədvəl şəklində müqayisə etmək rahatdır:

Kurs üçün biz qəsdən üçüncü variantı seçirik: ancaq bu halda feed‑dən tutmuş webhook‑lara və etibarlı production‑a qədər bütün yolu qət edə bilərik.

4. Satıcının məsuliyyəti: məlumatlar, sifarişlər, siyasət, pul

ChatGPT‑satıcısı olanda siz təkcə yeni sifarişlərin sevincinə yox, həm də çox konkret öhdəliklər toplusuna imza atırsınız. Gəlin onları qatlardan keçərək nəzərdən keçirək.

Kataloq məlumatları və Product Feed‑in keyfiyyəti

Product Feed — ChatGPT üçün həqiqətin mənbəyidir. Əgər orada məhsulun 10 USD olduğuna və mövcudluğuna dair qeyd varsa, istifadəçi çatda məhz bunu görəcək. Feed yanlış məlumat verərsə, ən yaxşı halda narazı müştəri, ən pis halda — siyasətin pozulması və OpenAI ilə problemlər alacaqsınız.

Satıcıdan gözlənilir:

• mütləq sahələrin düzgünlüyü (qiymət formatı düzgün, ISO valyuta kodları, etibarlı HTTPS keçidləri, işlək şəkillər);
• ghost məhsul satmamaq üçün feed‑in kifayət qədər tez‑tez yenilənməsi;
• identifikatorların konsistentliyi: feed‑dəki SKU id bazanızdakı və sifariş sisteminizdəki ID ilə üst‑üstə düşməlidir ki, nə alındığını dəqiq başa düşəsiniz.

Adi e‑commerce ilə paralel aparsaq, Product Feed burada sizin “marketplace‑ə eksport”unuzdur, sadəcə marketplace bu halda sayt deyil, istifadəçinin beynində yaşayan və uyğunsuzluqları asanlıqla yadda saxlayan ağıllı assistentdir.

Sifarişlər, çatdırılma və geri qaytarmalar

ChatGPT mağazanızın dəstək xidmətinə çevrilmir. İstifadəçi, əlbəttə, onunla danışır, lakin hüquqi cəhətdən məhsulu OpenAI yox, satıcıdan alır. Deməli:

• sifarişin sisteminizdə yaradılmasına və anbara qədər çatmasına siz cavabdehsiniz;
• göndərişin Instant Checkout‑da istifadəçi tərəfindən göstərilən ünvana çatmasına siz cavabdehsiniz;
• geri qaytarmaların, ləğvlərin, qismən geri qaytarmaların və s. emalına siz cavabdehsiniz.

ACP çərçivəsində checkout_session uğurla başa çatdıqdan sonra adətən öz sahələri ilə order obyektini ehtiva edir. Amma bu, sizin backendinizdə baş verənin sadəcə əksidir — məhz siz qərar verirsiniz ki, orders cədvəlindəki yazı necə görünür, hansı statuslar var, onlar logistika ilə necə bağlıdır.

Siyasət və coğrafiya

Merchants portalında hansı ölkələrdə və hansı məhsul tiplərini satdığınızı göstərirsiniz. OpenAI öz tərəfindən bunu yoxlayır ki, siz:

• qadağan olunmuş kateqoriyaları satmırsınız;
• yerli hüquqa əməl edirsiniz (məsələn, vergi qaydaları və yaş məhdudiyyətləri);
• açıq Terms of Service və Privacy Policy təqdim edirsiniz.

Sonrakı modullarda hüquqi səhifələrdən yenə danışacağıq, lakin artıq indi belə düşünmək faydalıdır: “Əgər mən hüquqşünasa harada və nə satdığımı izah edə bilməsəm, ChatGPT bunu mənim yerimə satmayacaq”.

Pul və ödəniş provayderi

Nəhayət, ən qorxulusu — pul. Yaxşı ki, ACP və Delegated Payment inkişaf etdiricinin işini xeyli sadələşdirir:

• ChatGPT və ödəniş provayderi (məsələn, Stripe) konkret məbləğ və satıcı üçün Shared Payment Token barədə razılaşırlar;
• backendiniz bu tokeni complete sorğusunda alır və PSP‑də istifadə edir, “xam” kart məlumatlarını görmür.

Yəni siz PCI uyğun monstraya çevrilmirsiniz, kart nömrələri saxlamırsınız və audit kabuslarına baş vurmursunuz. Sizin məsuliyyətiniz — delegasiya olunmuş tokeni düzgün istifadə etməkdir (ödəniş yaratmaq, pul tutmaq, geri qaytarmaq) və uçotu dəqiq aparmaq.

5. Bu, GiftGenius arxitekturasına necə oturur

Tədris tətbiqimiz GiftGenius‑a qayıdaq. Memarlıq baxımından 14‑cü moduldan sonra tələbənin belə bir səviyyədə sxem çəkə bilməsini istəyirik: “İstifadəçi → ChatGPT → App widget → MCP Gateway → Product Feed / Agents / ACP backend”.

Bu sxemdə satıcının rolu bizim backenddə reallaşdırılır, widget və App isə ChatGPT‑də bu satıcının “üzü” rolunda çıxış edir.

Kodda satıcının konfiqurasiyası

Sadə addımdan başlayaq: kodda satıcı konfiqurasiyası strukturu açaq. Gəlin bu, Next.js layihəmizdə lib/merchantConfig.ts TypeScript modulu olsun:

// lib/merchantConfig.ts
export type MerchantConfig = {
  id: string;                // Satıcının ACP/Stripe-dəki ID-si
  name: string;              // İnsan üçün oxunaqlı ad
  feedUrl: string;           // Product Feed harada yerləşir
  instantCheckoutEnabled: boolean;
};

export const giftGeniusMerchant: MerchantConfig = {
  id: process.env.MERCHANT_ID ?? "dev-merchant",
  name: "GiftGenius",
  feedUrl: process.env.PRODUCT_FEED_URL ?? "https://example.com/feed.json",
  instantCheckoutEnabled: false, // sonra aktivləşdirəcəyik
};

Burada, birincisi, sərhədləri açıq şəkildə qeyd edirik: bu, satıcıdır, “widget” deyil. İkincisi, vacib dəyərləri mühit dəyişənlərinə çıxarırıq — deploy və mühitlər barədə modullarda belə şeyləri nə üçün hardcode etməmək lazım olduğunu dəfələrlə xatırlayacağıq.

Rahatlıq üçün indi Instant Checkout‑dan istifadə oluna biləcəyini deyən sadə funksiya əlavə edə bilərsiniz:

// lib/merchantConfig.ts
export function canUseInstantCheckout(cfg: MerchantConfig) {
  // dev və staging-də həmişə Instant Checkout-u söndürürük
  if (process.env.NODE_ENV !== "production") return false;
  return cfg.instantCheckoutEnabled;
}

Beləliklə, memarlığı əvvəlcədən elə hazırlayırıq ki, müxtəlif mühitlərdə davranış fərqli ola bilsin və özümüzə (və GPT‑yə) test stendindən təsadüfən production checkout‑a getməyə imkan verməyək.

Satıcı haqqında məlumatı almaq üçün MCP aləti

Çox vaxt modelə və widget‑a satıcının hazırda hansı rejimdə işlədiyini öyrənmək imkanı vermək rahatdır. Məsələn, GPT Instant Checkout təklif etməsin, əgər o, söndürülübsə.

MCP‑serverində (keçən modullarda qaldırdığımız) sadə alət aça bilərsiniz:

// mcp/tools/merchant.ts
import { giftGeniusMerchant, canUseInstantCheckout } from "../lib/merchantConfig";

export const getMerchantInfoTool = {
  name: "get_merchant_info",
  description: "GiftGenius satıcısı haqqında baza məlumatı qaytarır",
  inputSchema: { type: "object", properties: {}, additionalProperties: false },
  async handler() {
    return {
      id: giftGeniusMerchant.id,
      name: giftGeniusMerchant.name,
      instantCheckout: canUseInstantCheckout(giftGeniusMerchant),
    };
  },
};

Bu alət heç bir möcüzə etmir, amma modelin “İndi birbaşa çatda almaq olar, yoxsa yalnız keçid vermək?” sualını verə biləcəyi açıq bir yer yaradır.

Widget‑də satıcı məlumatından istifadə

Widget tərəfində, artıq tanış olduğumuz Apps SDK hook‑larını istifadə edərək, get_merchant_info çağırmaq və rejimdən asılı olaraq UI‑ı dəyişmək olar. Komponentin ən sadə nümunəsi:

// components/MerchantBadge.tsx
"use client";

import { useEffect, useState } from "react";
import { useCallTool } from "../lib/use-call-tool";

type MerchantInfo = { name: string; instantCheckout: boolean };

export function MerchantBadge() {
  const callTool = useCallTool();
  const [info, setInfo] = useState<MerchantInfo | null>(null);

  useEffect(() => {
    callTool("get_merchant_info", {}).then((res) => {
      setInfo(res?.result as MerchantInfo);
    });
  }, [callTool]);

  if (!info) return null;
  return (
    <span>
      {info.name} · {info.instantCheckout ? "Instant Checkout" : "Discovery only"}
    </span>
  );
}

Belə kiçik bir komponent istifadəçiyə (və sizə, dev rejimində) inteqrasiyanın hazırda hansı vəziyyətdə olduğunu xoş şəkildə vurğulayır.

6. Praktik mini tapşırıq

Mühazirə təkcə “sözlər və diaqramlar” səviyyəsində qalmasın deyə, layihənizdə (GiftGenius və ya oxşarı) aşağıdakı addımları sınayın:

Birincisi, merchantConfig.ts‑ə bənzər satıcı konfiqurasiyası modulunu əlavə edin və MERCHANT_ID və PRODUCT_FEED_URL‑u mühit dəyişənlərinə çıxarın. Lokal inkişaf üçün .env.local, production üçün isə Vercel və ya başqa platformanın ayarlarından istifadə etmək olar.

İkincisi, MCP‑serverində ən azı name və instantCheckout qaytaran sadə get_merchant_info alətini reallaşdırın. Model üçün daha hansı sahələrin faydalı ola biləcəyini düşünün: məsələn, dəstəklənən valyutalar və ya çatdırılma ölkələrinin siyahısı.

Üçüncüsü, widget‑a bu alətdən istifadə edən və istifadəçiyə satıcınızın hazırda hansı rejimdə işlədiyini göstərən kiçik UI elementi (beij, status sətri, məhsul kartında imza) əlavə edin: yalnız tövsiyələr, yoxsa artıq tamhüquqlu Instant Checkout. Bu təkcə UX üçün faydalı deyil, həm də sazlamada əla köməkdir.

Sonda, layihənizin “bizdə sayt və backend var” mərhələsindən ChatGPT‑satıcısı statusuna hansı addımlarla gedəcəyini mətndə yazmağa çalışın. Product Feed‑i məhz harada qoşacaqsınız, enable_checkout‑u nə vaxt aktivləşdirəcəksiniz, ACP endpointlərinin reallaşdırılmasına nə vaxt başlayacaqsınız. Belə məşq intizamlandırır və geri qaytarma siyasəti kimi xoşlanılmayan vacib şeyləri unutmağa imkan vermir.

7. ChatGPT‑satıcısı yolunda tipik səhvlər

Səhv №1: “ChatGPT — elə mənim mağazamdır”.
Bəzən inkişaf etdiricilər hər şeyi düşüncədə ChatGPT tərəfinə “köçürür”: guya o həm kataloqu saxlayır, həm qiyməti hesablayır, həm də sifarişləri icra edir. Reallıqda ChatGPT sizin ERP deyil, interfeys və orkestratordur. Bunu unutmaqla elə memarlıq qurmaq asandır ki, normal öz sifariş modeliniz yoxdur, bütün məlumatlar “haradasa promptlarda” yaşayır və modelin davranışındakı istənilən dəyişiklik konsistentliyin itirilməsi ilə hədələyir.

Səhv №2: ayrıca qeydiyyat və ACP olmadan Instant Checkout gözləntisi.
Sizin əla widget yazmağınız və Product Feed qurmağınız Instant Checkout‑u avtomatik aktivləşdirmir. Merchants portalında müraciət, kateqoriyaların yoxlanması, Agentic Checkout və Delegated Payment reallaşdırılması, testlərdən keçmək lazımdır. Instant Checkout‑a “default” kimi ümid bağlamaq adətən GPT‑nin istifadəçiyə əslində olmayan şeyi təklif etməsi və ya gözlənilən ödəniş ekranları əvəzinə keçidlər verməsi ilə yekunlaşır.

Səhv №3: satıcı identifikatorlarının və URL‑lərin sərt hardcode edilməsi.
Klassik hekayə: MERCHANT_ID = "prod-123" birbaşa kodda yazılıb, feed URL‑i — widget komponentində sətir kimi. Sizdə staging peyda olan kimi və ya ikinci satıcı lazım olanda kütləvi “axtar‑və‑əvəz et” başlayır. Bizim MerchantConfig ilə etdiyimiz kimi, belə şeyləri konfiqurasiya və mühit dəyişənlərinə çıxarmaq və kiçik abstraksiya qatı ilə istifadə etmək daha təhlükəsizdir.

Səhv №4: Product Feed sifarişlərdən ayrı “öz həyatı” ilə yaşayır.
Əgər feed‑də SKU GIFT_RED_MUG üçün 10 USD yazılıbsa, amma sifariş bazasında eyni identifikator üzrə hansısa səbəbdən 12 USD tutursunuzsa, bu gec‑tezcə üzə çıxacaq. Qiymətlər və mövcudluq üzrə həqiqət mənbəyi ya daxili məlumatlarınızdan yığılan feed olmalıdır, ya da feed və checkout‑un güvəndiyi ümumi aralıq qat. “İkiqat mühasibatlıq” (biri ChatGPT üçün, biri öz saytınız üçün) cəhdi çox tez başa bəla olur.

Səhv №5: ödəniş provayderinin rolunu və ödəniş məlumatlarının saxlanmasını görməzdən gəlmək.
Bəzən ödəniş provayderinin tokeninə “göz yetirmək” və ya hətta öz UI‑ınızda istifadəçidən əlavə ödəniş rekvizitləri istəmək həvəsi yaranır. Bu, təkcə Delegated Payment modelini pozmur, həm də sizi PCI DSS dünyasına və ağır uyğunluq tələblərinə sala bilər. Düzgün praktika — Shared Payment Token‑ə qeyri‑şəffaf sətir kimi yanaşmaq, onu yalnız ödəniş provayderinin SDK‑sında istifadə etmək və heç yerdə loglamamaq və keşləməməkdir.

Səhv №6: onboarding‑in çoxmərhələliyini kiçik qiymətləndirmək və planın olmaması.
Nəhayət, yayğın təşkilati səhv — “biz sadəcə ChatGPT‑yə qoşulacağıq, nə var ki?” düşünməkdir. Əslində satıcının yolu çoxlu addımlardan ibarətdir: texniki (feed, backend, testlər) və texniki olmayan (hüquqi sənədlər, kateqoriyaların razılaşdırılması, regional məhdudiyyətlər). Bu yolu əvvəlcədən yazmasanız, komanda tapşırıqlar arasında xaotik şəkildə hoppanacaq və deadline‑lar sizin AI‑commerce‑dən ilhamınızdan daha sürətlə “əriyəcək”.