İçgörülerAltyapı

UCP'ye hazırlık: bir profil dosyası ve beş yetenek, her biri mağazanızdaki bir veriye bağlı

Universal Commerce Protocol'e hazırlık iki şeye iner: /.well-known/ucp adresindeki profil dosyası ve beş alışveriş yeteneği (Catalog, Cart, Checkout, Identity Linking, Order). Her biri mağazanın zaten tuttuğu bir veriye dayanır. UCP ile ödeme bugün nerede açık, Türkiye'den ne hazırlanır?

Bir mağaza sahibi, altyapısının artık "UCP desteklediğini" duyuyor ve soruyor: Benim ne yapmam gerekiyor? Kulağa bir düğme gibi geliyor. Gerçekte mağazanızın yayımladığı bir dosya ve her biri zaten tuttuğunuz bir veriye dayanan beş yetenek var; o verilerin bir kısmı hazır, bir kısmı değil.

Bu yazıda Universal Commerce Protocol'ün güncel sürümüne mağaza tarafından bakıyoruz: profil dosyası, her yeteneğin sizden beklediği, UCP ile ödemenin bugün açık olduğu yerler ve Türkiye'den neler hazırlanabileceği. Protokollerin hangi katmanların üstüne oturduğunu önce katmanlar, sonra protokoller yazısında anlatmıştık; bu yazı oradan çıkan iş listesi.

UCP bugün: tarihli bir sürüm, beş yetenek

UCP sürümleri tarihle adlandırılıyor. Güncel sürüm 2026-08-25; öncekiler 2026-01-11, 2026-01-23 ve 2026-04-08. Bu sürümde geriye uyumsuz bir değişiklik var: teslimat (fulfillment) şeması yeniden düzenlendi, eski entegrasyonlar gözden geçirilmeli. Sürüm ayrıca şunları getirdi:

  • Market alışverişi. Konum arama, çalışma saatleri ve kesirli miktar.
  • Ödeme. Satıcıdan bağımsız 3D Secure (3DS2) akışı; taksit, depozito, ertelenmiş ve bölünmüş ödeme.
  • Sadakat. Bir sadakat uzantısı.
  • Ajan kimliği. Web Bot Auth uyumu.
  • Politikalar. Politika anlık görüntüsü.

UCP sitesi beş alışveriş yeteneği sayıyor: Catalog, Cart, Checkout, Identity Linking ve Order. Konaklama rezervasyonu (dev.ucp.lodging.booking, 25 Eylül 2026 duyurusu) ve yemek siparişi (dev.ucp.food.checkout, 12 Kasım 2026 duyurusu) bunlardan ayrı ve hâlâ taslak. ucp.dev'e göre AP2, A2A ve MCP desteği protokolün içinde, hesap bağlama OAuth 2.0 ile yapılıyor ve satıcı kaydı (merchant of record) işletmede kalıyor.

Google 11 Ocak 2026'daki lansmanda Shopify, Etsy, Wayfair, Target ve Walmart'ı ortak geliştirici saydı. Amazon, Meta, Microsoft, Salesforce ve Stripe 24 Nisan 2026'da Teknik Konsey'e katıldı; ucp.dev onları da ortak geliştirici gösteriyor.

Profil dosyası: mağazanızın kapısı

Ajan önce işletme profilinizi okur. Belirtimin kuralları net:

  • Yer. Alan adınızda /.well-known/ucp adresinden, HTTPS ile sunulur.
  • Yönlendirme yok. 3xx yanıtı yasak. Site genelinde www'ya ya da dil klasörüne yönlendirme varsa bu adres istisna olmalı.
  • Önbellek. Yanıtta Cache-Control: public ve en az 60 saniyelik max-age bulunur.
  • Zorunlu alanlar. ucp.version, ucp.services ve ucp.payment_handlers.
  • Taşıma türü. Her servis nasıl erişildiğini bildirir: rest, mcp, a2a ya da embedded.
  • İmza anahtarları. Açık anahtarlar keys[] dizisinde durur.
UCP işletme profili kuralları: /.well-known/ucp adresinde HTTPS ile sunulur, 3xx yönlendirme yok, Cache-Control public ve en az 60 saniyelik max-age, üç zorunlu alan.
İşletme profili küçük bir dosya ama sunulma kuralları sıkı. Kaynak: UCP belirtimi, 2026-08-25 sürümü.

Dosyayı kim yazarsa yazsın, sitenin önündeki güvenlik ya da önbellek katmanı yönlendirme ve önbellek kurallarını sessizce bozabilir.

Ne yapmalı: /.well-known/ucp adresini kendiniz isteyin; yalnız sayfanın açıldığına değil, durum koduna ve başlıklara da bakın.

Beş yetenek, mağazada beş veri

Her yetenek, mağazanın insanlar için yaptığı bir işi ajana standart bir yolla açıyor.

UCP'nin beş alışveriş yeteneği ve mağazadaki karşılıkları: Catalog ürün verisi, Cart sepet, Checkout ödeme adımı ve ödeme sağlayıcısı, Identity Linking müşteri hesabı ve OAuth 2.0, Order sipariş durumu; her biri çoğu mağazada var ya da iş istiyor diye işaretli.
Her UCP yeteneği, mağazanın zaten yürüttüğü bir şeye dayanıyor. Durum sütunu genel bir yol göstericidir, ölçüm değildir.
  • Catalog. Ürün veriniz ve feed'iniz. Her mağazada var; soru, zorunlu alanların dolu olup olmadığı.
  • Cart. Sepetiniz. Seçenek ve adet, menülere tıklamadan belirtilebilmeli.
  • Checkout. Ödeme adımınız ve ödeme sağlayıcınız. İşin çoğu burada: profil ucp.payment_handlers listesini istiyor, yani ödeme sağlayıcınızın hangilerini verebildiğini bilmeniz gerek.
  • Identity Linking. OAuth 2.0 ile bağlanan müşteri hesapları. Üyelik sistemi varsa hesap tarafı hazır; ajanın hesabı OAuth 2.0 ile bağlaması ayrı iş. Zorunlu üyeliğin ajanı nerede durdurduğunu üyeliksiz alışveriş yazısında anlattık.
  • Order. Sipariş durumu ve kargo takibi. Çoğu zaman yalnız e-postada ya da giriş gerektiren bir sayfada duruyor.

Ne yapmalı: Her yetenek için verinin nerede durduğunu ve kimin baktığını yazın. Sahipsiz olanlar iş listenizdir.

Katalog ürün verinizden ne istiyor?

2026-08-25 sürümündeki Catalog yeteneği üründe beş alanı zorunlu tutuyor: id, title, description, price_range ve variants. media, rating ve list_price_range isteğe bağlı. Stok yalnız varyantta, isteğe bağlı availability alanında duruyor; belirtimdeki örnekte "available": true yazıyor, adet yok.

İki ayrıntı önemli:

  • Yük varyantlarda. Varyantları düzgün tanımlanmamış bir ürün, hangi beden ya da rengin stokta olduğunu söyleyemez.
  • Politikalar ayrı varlık. İade ve garanti politikası ürün alanı değil. UCP bunları dev.ucp.shopping.policy.return ve dev.ucp.shopping.policy.warranty olarak ayrı tanımlıyor. İade koşulu ürüne göre değişip tek bir metin sayfasında anlatılan mağaza bunu ilk hisseder. Metin tarafı için: iade politikanızı ajanlar nasıl okuyor.

Ne yapmalı: Her üründe gerçek bir açıklama, varyantlarla tutarlı fiyat aralığı ve varyant düzeyinde stok olsun.

Alışverişçi UCP ile bugün nerede ödeyebiliyor?

Google, 11 Ocak 2026'daki lansmanda uygun ABD'li perakendecilerden ödeme sundu. 4 Kasım 2026'da Kanada'daki alışverişçilere AI Mode ve Gemini uygulamasında açmaya başladı. 16 Eylül 2026'da yeni UCP yeteneklerinin ABD'de başlayıp Avustralya ve Kanada'ya "gelecek yılın başında" geleceğini, 19 Mayıs 2026'da Birleşik Krallık'ın "daha sonra" geleceğini yazdı. Türkiye ve AB için tarih açıklanmadı.

Mağazanın bu ülkelerde olması şart değil. Shopify'ın Google AI Mode ve Gemini kanalı için yardım sayfasına göre şart, ABD, Kanada ya da Avustralya'daki müşterilere satış yapmak; mağaza her yerde olabilir. Yani bu pazarlara satan, Shopify kullanan Türkiye'deki bir mağaza katılabilir. Yalnız Türkiye'ye satan mağaza veriyi hazırlayabilir, ama Google'da UCP ile ödeme henüz onun müşterilerine açık değil. Google'ın aynı veriyi sonradan nasıl yeniden okuduğu Universal Cart yazımızda.

Bu ay neler hazırlanabilir?

  1. Her ürün için beş zorunlu katalog alanını doldurun; fiyat ve stok her varyantta ayrı olsun.
  2. İade ve garanti koşullarını, her gerçek kural için bir politika olarak yazın.
  3. Altyapınıza /.well-known/ucp yayımlayıp yayımlamadığını, hangi UCP sürümünü hedeflediğini ve 2026-08-25 teslimat değişikliğine uyduğunu sorun.
  4. Ödeme sağlayıcınıza UCP ödeme işleyicisi sunup sunmadığını ve hangi ülkelerde sunduğunu sorun.
  5. Profil adresini kendi ağınızın dışından deneyin: HTTPS, yönlendirme yok, önbellek başlığı var.
  6. Giriş gerekiyorsa OAuth 2.0 ile hesap bağlamayı planlayın; gerekmiyorsa misafir alışverişi açık tutun.
  7. Sipariş durumunu yalnız e-postada değil, okunabilir bir sayfada da gösterin.

Sonuç

"UCP'ye hazır olmak" bir rozet değil. Birkaç sunum kuralına uyan bir profil dosyası ve her biri zaten elinizde olan bir veriye dayanan beş yetenek. Katalog ve sipariş verisi çoğu zaman hazıra en yakın; ödeme ve hesap bağlama için ödeme sağlayıcınız ve altyapınız gerekiyor. UCP ile ödeme şimdilik birkaç ülkede açık, veri işi ise her yerde karşılık bulur.

Specoria, ürün yapısal verinizin, teklif bilgilerinizin ve iade politikanızın eksiksiz ve makinece okunur olup olmadığını kontrol ediyor; Catalog yeteneğinin dayandığı veri de bu. Ücretsiz hazırlık testiyle başlayın.


Kaynaklar