1.0 UCP nedir?
Evrensel Ticaret Protokolü (UCP), yeni nesil ajan tabanlı ticareti desteklemek üzere tasarlanmış açık kaynaklı bir standarttır. Ortak bir dil ve işlevsel temel öğeler oluşturarak, UCP tüketici yüzeyleri, işletmeler ve ödeme sağlayıcıları arasında sorunsuz ticaret yolculukları sağlar. Mevcut perakende altyapısıyla çalışmak üzere tasarlanmıştır ve güvenli ajan tabanlı ödeme desteği sağlamak için Ajan Ödeme Protokolü ( AP2 ) ile uyumludur. Ayrıca işletmelere API’ler, Agent2Agent ( A2A ) ve Model Bağlam Protokolü ( MCP ) aracılığıyla entegre olmanın esnek yollarını sunmaktadır.
UCP, Google tarafından Shopify, Etsy, Wayfair, Target ve Walmart gibi sektör liderleriyle iş birliği içinde geliştirilmiştir ve Adyen, American Express, Best Buy, Flipkart, Macy’s Inc, Mastercard, Stripe, The Home Depot, Visa, Zalando ve daha birçok küresel ortak tarafından destekleniyor.
UCP, tüm ticaret ekosistemine fayda sağlamak üzere tasarlanmıştır.
- İşletmeler için: UCP, Google Arama’daki Yapay Zeka Modu ve Gemini uygulaması gibi tüketici arayüzlerinde ve gelecekte diğer platformlarda benzersiz ürün ve hizmet tekliflerinizi sergilemenizi sağlar. UCP ile işletme mantığınızın sahibi sizsiniz ve kayıtlı satıcı olarak kalırsınız. UCP, perakendecilerin esnekliği için tasarlanmıştır ve ilk günden itibaren tamamen özelleştirilmiş bir ödeme deneyimi sağlamanıza olanak tanıyan ‘yerleşik bir seçenek’ sunar.
- Yapay zeka platformları için: UCP ile hedef kitleniz için aracı tabanlı alışverişi etkinleştirebilirsiniz. Standartlaştırılmış API’ler kullanarak işletme entegrasyonunu basitleştirirken, onlara MCP, A2A ve tercih ettikleri mevcut aracı çerçevelerini kullanma esnekliği de sağlayabilirsiniz.
- Geliştiriciler için: UCP, topluluk odaklı olarak tasarlanmış, sürekli gelişen bir açık kaynak standardıdır. Sizleri bizimle birlikte yeni nesil dijital ticareti inşa etmeye davet ediyoruz.
- Ödeme sağlayıcıları için: UCP’nin açık, modüler ödeme işleyici tasarımı, açık birlikte çalışabilirlik ve ödeme yöntemleri seçeneği sunar. Bu tasarım sayesinde UCP, kanıtlanabilir evrensel ödemeleri mümkün kılar. Her yetkilendirme, kullanıcının onayının kriptografik kanıtıyla desteklenir.
- Tüketiciler için: Favori markalarınız UCP’yi benimsediğinde, ürün keşfinden karar verme aşamasına kadar olan süreçteki engeller ortadan kalkar; böylece sevdiğiniz markalardan gönül rahatlığıyla alışveriş yapabilir ve üyelik avantajlarınız da dahil olmak üzere en iyi değeri elde edebilirsiniz.
Yeni, esnek bir standardın gerekliliği
Tüketiciler konuşmaya dayalı deneyimleri benimsedikçe, fikir üretme ve araştırmadan nihai satın almaya kadar sorunsuz geçişler bekliyorlar. Bu da, kullanıcının mevcut konuşma bağlamı içinde gerçek zamanlı stok kontrolü, dinamik fiyatlandırma ve anlık işlemleri desteklemenin kritik önem taşıdığı anlamına geliyor.
Ancak, geleneksel teknoloji altyapısı bu etkileşimli dönüşümü desteklemeyi zorlaştırıyor. İşletmeler N x N entegrasyon darboğazıyla karşı karşıya kalıyor ve bu da onları her yüzey için özel bağlantılar kurmaya zorluyor; bu da ekosistemin keyifli etkileşimli ticari deneyimlere doğru kaymasını yavaşlatıyor.
Sektör liderleriyle iş birliği içinde geliştirilen UCP, bu darboğazı aşmak ve tüm ticaret ortamının gelişen ihtiyaçlarını karşılamak üzere tasarlanmıştır. Eski sistemlerin aksine, UCP, keşif ve değerlendirmeden satın alma ve sipariş yönetimine kadar tüm ticaret yolculuğunu tek bir güvenli soyutlama katmanı aracılığıyla standartlaştırır:
- Birleşik entegrasyon: N x N karmaşıklığını tüm tüketici yüzeyleri için tek bir entegrasyon noktasına indirger.
- Ortak dil: Platformlar arası birlikte çalışabilirliği ve tüm ticaret yaşam döngüsü için uçtan uca desteği sağlamak amacıyla keşif, yetenek şeması ve taşıma bağlamlarını standartlaştırır.
- Genişletilebilir mimari: Yeni ajan tabanlı deneyimler ortaya çıktıkça kolayca ölçeklenebilen esnek yetenekler ve uzantılar çerçevesiyle oluşturulmuştur. Bu tasarım tercihi, UCP’nin yeni sektörlere yayılmasına da olanak tanır.
- Önce güvenlik yaklaşımı: Temsilciler ve iş arka uçları arasında güvenli bir iletişim yolu olarak tokenleştirilmiş ödemeler ve doğrulanabilir kimlik bilgileri sağlar.
UCP, entegrasyon karmaşıklığını azaltarak ve teknik engelleri ortadan kaldırarak işletmelerin aracı tabanlı ticaretin yeni çağına aktif olarak katılmasını sağlar.
UCP Genel Bakış
UCP, ticaret ekosisteminde ajan tabanlı deneyimleri desteklemek üzere tasarlanmıştır. Tüketici arayüzlerinin (örneğin Arama’daki Yapay Zeka Modu, Gemini ve diğerleri) işletme arka uçlarına (ürün keşfi, sepet ödeme vb.) standartlaştırılmış ve güvenli bir şekilde bağlanması için net bir dil oluşturuyor.
İşletmeler ve aracı kurumlar, desteklemek istedikleri hizmetleri (örneğin, Alışveriş ve diğer dikey sektörler) seçer ve bunlara karşılık gelen yetenekleri kullanıma sunar. Yetenekler, ödeme ve ürün keşfi gibi temel ticaret yapı taşlarıdır. Bu yetenekler ayrıca, indirimler gibi özel işlevlerle bu yetenekleri artıran uzantılara da sahip olabilir. UCP’nin keşif mekanizması, aracı kurumların profiller aracılığıyla işletme yeteneklerini ve ödeme seçeneklerini dinamik olarak keşfetmelerini sağlamaktadır.
Ek olarak, UCP, tüketicilerin ödeme yapmak için kullandıkları araçları (ödeme araçları) ödeme işleyicilerinden (ödeme işlemcileri) ayırarak benzersiz bir ödeme mimarisi modeli oluşturur ve bu sayede mevcut çeşitli ödeme sağlayıcılarına uyum sağlayabilir. UCP ayrıca, işletmelerin ve aracıların iletişim kurması için esneklik sağlamak amacıyla A2A, MCP ve API’ler dahil olmak üzere birden fazla taşıma yöntemini destekler. Örneğin, Ödeme Yeteneği, platformunuzun ihtiyaçlarına bağlı olarak bir REST API bağlantısına veya bir MCP bağlantısına sahip olabilir.
2.0 Nasıl çalışır
UCP’nin nasıl çalıştığını görmek için örnek bir işletme mağazası ve bir temsilci kullanalım.
İşte önerilen adımlar:
- Bir işletme sunucusu kurun ve mağazanıza örnek ürünler ekleyin.
- İşletme sunucunuzu temsilcilerden gelen istekleri kabul edecek şekilde hazırlayın.
- Temsilcinizin işletme yeteneklerini keşfetmesini sağlayın.
- Temsilcinizle bir ödeme işlemi başlatın.
- İndirimleri, temsilciniz aracılığıyla ödeme talebinize uygulayın.
2.1 İşletme sunucusunu kurun ve mağazanıza örnek ürünler ekleyin.
Bir iş sunucusu kurmak için, İş API’lerini barındıracak Python sunucusunu ve örnek ürün verilerini içeren bir UCP SDK’sını içeren bir Örnekler deposu oluşturduk.
İşletme sunucusunu kurun:
mkdir sdk
git clone https://github.com/Universal-Commerce-Protocol/python-sdk.git sdk/python
pushd sdk/python
uv sync
popd
git clone https://github.com/Universal-Commerce-Protocol/samples.git
cd samples/rest/python/server
uv syncKullandığımız işletme bir demo çiçekçi dükkanıdır. Demo için örnek ürünleri saklamamıza olanak sağlayan SQLite tabanlı bir örnek ürün veritabanımız var.
İşletmeniz için örnek ürünlerle doldurulmuş yerel bir veritabanı oluşturmak için aşağıdaki komutu çalıştırın:
mkdir /tmp/ucp_test
uv run import_csv.py \
--products_db_path=/tmp/ucp_test/products.db \
--transactions_db_path=/tmp/ucp_test/transactions.db \
--data_dir=../test_data/flower_shop2.2 İş sunucunuzu temsilcilerden gelen istekleri kabul edecek şekilde hazırlayın.
İş API’lerini barındıran iş sunucusunu, örnek ürünler veritabanına işaret eden 8182 numaralı portta başlatın. Sunucuyu arka planda çalıştırıp sürekli açık tutuyoruz, böylece istemci ona bağlanabiliyor.
İş sunucusunu başlatmak için aşağıdaki komutu çalıştırın:
uv run server.py \
--products_db_path=/tmp/ucp_test/products.db \
--transactions_db_path=/tmp/ucp_test/transactions.db \
--port=8182 &
SERVER_PID=$!2.3 Temsilcinizle iş olanaklarını keşfedin
İşletmeler, destekledikleri hizmetleri ve ilgili yeteneklerini, adresinde bulunan standart bir JSON manifest dosyasında yayınlarlar /.well-known/ucp. Bu, temsilcilerin sabit kodlanmış entegrasyonlara gerek kalmadan özellikleri, uç noktaları ve ödeme yapılandırmalarını dinamik olarak keşfetmelerini sağlar.
Aracınızın işletme hizmetlerini ve yeteneklerini keşfetmesi için aşağıdaki komutu çalıştırın:
export SERVER_URL=http://localhost:8182
export RESPONSE=$(curl -s -X GET $SERVER_URL/.well-known/ucp)
echo $RESPONSEResponse:
{
"ucp": {
"version": "2026-01-11",
"services": { "dev.ucp.shopping": { "version": "2026-01-11", "spec": "https://ucp.dev/specs/shopping", "rest": { "schema": "https://ucp.dev/services/shopping/openapi.json", "endpoint": "http://localhost:8182/" } } },
"capabilities": [
{ "name": "dev.ucp.shopping.checkout", "version": "2026-01-11", "spec": "https://ucp.dev/specs/shopping/checkout", "schema": "https://ucp.dev/schemas/shopping/checkout.json" },
{ "name": "dev.ucp.shopping.discount", "version": "2026-01-11", "spec": "https://ucp.dev/specs/shopping/discount", "schema": "https://ucp.dev/schemas/shopping/discount.json", "extends": "dev.ucp.shopping.checkout" },
{ "name": "dev.ucp.shopping.fulfillment", "version": "2026-01-11", "spec": "https://ucp.dev/specs/shopping/fulfillment", "schema": "https://ucp.dev/schemas/shopping/fulfillment.json", "extends": "dev.ucp.shopping.checkout" }
]
},
"payment": {
"handlers": [
{ "id": "shop_pay", "name": "com.shopify.shop_pay", "version": "2026-01-11", "spec": "https://shopify.dev/ucp/handlers/shop_pay", "config_schema": "https://shopify.dev/ucp/handlers/shop_pay/config.json", "instrument_schemas": [ "https://shopify.dev/ucp/handlers/shop_pay/instrument.json" ], "config": { "shop_id": "d124d01c-3386-4c58-bc58-671b705e19ff" } },
{ "id": "google_pay", "name": "google.pay", "version": "2026-01-11", "spec": "https://example.com/spec", "config_schema": "https://example.com/schema", "instrument_schemas": [ "https://ucp.dev/schemas/shopping/types/gpay_card_payment_instrument.json"
], "config": { "api_version": 2, "api_version_minor": 0, "merchant_info": { "merchant_name": "Flower Shop", "merchant_id": "TEST", "merchant_origin": "localhost" }, "allowed_payment_methods": [ { "type": "CARD", "parameters": { "allowedAuthMethods": [ "PAN_ONLY", "CRYPTOGRAM_3DS" ], "allowedCardNetworks": [ "VISA", "MASTERCARD" ] }, "tokenization_specification": [ { "type": "PAYMENT_GATEWAY", "parameters": [ { "gateway": "example", "gatewayMerchantId": "exampleGatewayMerchantId" } ] } ] } ] } },
{ "id": "mock_payment_handler", "name": "dev.ucp.mock_payment", "version": "2026-01-11", "spec": "https://ucp.dev/specs/mock", "config_schema": "https://ucp.dev/schemas/mock.json", "instrument_schemas": [ "https://ucp.dev/schemas/shopping/types/card_payment_instrument.json" ], "config": { "supported_tokens": [ "success_token", "fail_token" ] } }
]
}
}Tam yanıt örneği .
2.4 Temsilcinizle ödeme işlemini etkinleştirme
Temsilcinizin örnek ürünlerle bir ödeme oturumu oluşturması için aşağıdaki komutu çalıştırın:
export RESPONSE=$(curl -s -X POST "$SERVER_URL/checkout-sessions" -H 'Content-Type: application/json' -H 'UCP-Agent: profile="https://agent.example/profile"' -H 'request-signature: test' -H 'idempotency-key: 0b50cc6b-19b2-42cd-afee-6a98e71eea87' -H 'request-id: 6d08ae4b-e7ea-44f4-846f-d7381919d4f2' -d '{"line_items":[{"item":{"id":"bouquet_roses","title":"Red Rose"},"quantity":1}],"buyer":{"full_name":"John Doe","email":"john.doe@example.com"},"currency":"USD","payment":{"instruments":[],"handlers":[{"id":"shop_pay","name":"com.shopify.shop_pay","version":"2026-01-11","spec":"https://shopify.dev/ucp/handlers/shop_pay","config_schema":"https://shopify.dev/ucp/handlers/shop_pay/config.json","instrument_schemas":["https://shopify.dev/ucp/handlers/shop_pay/instrument.json"],"config":{"shop_id":"d124d01c-3386-4c58-bc58-671b705e19ff"}},{"id":"google_pay","name":"google.pay","version":"2026-01-11","spec":"https://example.com/spec","config_schema":"https://example.com/schema","instrument_schemas":["https://ucp.dev/schemas/shopping/types/gpay_card_payment_instrument.json"],"config":{"api_version":2,"api_version_minor":0,"merchant_info":{"merchant_name":"Flower Shop","merchant_id":"TEST","merchant_origin":"localhost"},"allowed_payment_methods":[{"type":"CARD","parameters":{"allowedAuthMethods":["PAN_ONLY","CRYPTOGRAM_3DS"],"allowedCardNetworks":["VISA","MASTERCARD"]},"tokenization_specification":[{"type":"PAYMENT_GATEWAY","parameters":[{"gateway":"example","gatewayMerchantId":"exampleGatewayMerchantId"}]}]}]}},{"id":"mock_payment_handler","name":"dev.ucp.mock_payment","version":"2026-01-11","spec":"https://ucp.dev/specs/mock","config_schema":"https://ucp.dev/schemas/mock.json","instrument_schemas":["https://ucp.dev/schemas/shopping/types/card_payment_instrument.json"],"config":{"supported_tokens":["success_token","fail_token"]}}]}}') && echo $RESPONSEÖrnek talep formunun tamamı .
Ödeme oturumu oluşturulduktan sonra, temsilciniz sunucudan bir ödeme kimliği alacaktır; bu kimlik, ödeme oturumunda yapılacak diğer güncellemeler için kullanılabilir:
RESPONSE:
{
"ucp": { "version": "2026-01-11", "capabilities": [ { "name": "dev.ucp.shopping.checkout", "version": "2026-01-11" } ] },
"id": "cb9c0fc5-3e81-427c-ae54-83578294daf3",
"line_items": [ {
"id": "2e86d63a-a6b8-4b4d-8f41-559f4c6991ea",
"item": { "id": "bouquet_roses", "title": "Bouquet of Red Roses", "price": 3500 },
"quantity": 1,
"totals": [ { "type": "subtotal", "amount": 3500 }, { "type": "total", "amount": 3500 } ]
} ],
"buyer": { "full_name": "John Doe", "email": "john.doe@example.com" },
"status": "ready_for_complete",
"currency": "USD",
"totals": [ { "type": "subtotal", "amount": 3500 }, { "type": "total", "amount": 3500 } ],
"links": [],
"payment": { "handlers": [], "instruments": [] },
"discounts": {}
}Tam yanıt örneği .
2.5 İndirimleri ödeme talebine uygulamak için temsilcinizi kullanın.
Temsilcinizin önceki adımda aldığınız ödeme kimliğini kullanarak ödeme oturumuna indirim uygulamasını sağlamak için bu komutu çalıştırın:
export CHECKOUT_ID=$(echo $RESPONSE | jq -r '.id') && export LINE_ITEM_1_ID=$(echo $RESPONSE | jq -r '.line_items[0].id') && export RESPONSE=$(curl -s -X PUT "$SERVER_URL/checkout-sessions/$CHECKOUT_ID" -H 'Content-Type: application/json' -H 'UCP-Agent: profile="https://agent.example/profile"' -H 'request-signature: test' -H 'idempotency-key: b9ecd4b3-0d23-4842-8535-0d55e76e2bad' -H 'request-id: 28e70993-e328-4071-91de-91644dc75221' -d "{\"id\":\"$CHECKOUT_ID\",\"line_items\":[{\"id\":\"$LINE_ITEM_1_ID\",\"item\":{\"id\":\"bouquet_roses\",\"title\":\"Red Rose\"},\"quantity\":1}],\"currency\":\"USD\",\"payment\":{\"instruments\":[],\"handlers\":[]},\"discounts\":{\"codes\":[\"10OFF\"]}}") && echo $RESPONSE | jqRESPONSE:
{
"ucp": { "version": "2026-01-11", "capabilities": [ { "name": "dev.ucp.shopping.checkout", "version": "2026-01-11" } ] },
"id": "cb9c0fc5-3e81-427c-ae54-83578294daf3",
"line_items": [ {
"id": "2e86d63a-a6b8-4b4d-8f41-559f4c6991ea",
"item": { "id": "bouquet_roses", "title": "Bouquet of Red Roses", "price": 3500 },
"quantity": 1,
"totals": [ { "type": "subtotal", "amount": 3500 }, { "type": "total", "amount": 3500 } ] } ],
"buyer": { "full_name": "John Doe", "email": "john.doe@example.com" },
"status": "ready_for_complete",
"currency": "USD",
"totals": [ { "type": "subtotal", "amount": 3500 }, { "type": "discount", "amount": 350 }, { "type": "total", "amount": 3150 } ],
"links": [],
"payment": { "handlers": [], "instruments": [] },
"discounts": {
"codes": [ "10OFF" ],
"applied": [ { "code": "10OFF", "title": "10% Off", "amount": 350, "automatic": false, "allocations": [ { "path": "subtotal", "amount": 350 } ] } ]
}
}Tam yanıt örneği .
UCP üzerinden işletme ve temsilci iletişimini inceledikten sonra, işletme sunucusunu durdurmak için aşağıdaki komutu kullanabilirsiniz:
kill ${SERVER_PID}Özet:
Bir işletme sunucusu ve ajanı kurduk. UCP’yi kullanarak, ajanların işletmenizin yeteneklerini nasıl keşfedebileceğini, ödeme işlemini nasıl başlatabileceğini ve hatta ödeme isteğinde nasıl indirim uygulayabileceğini gördük. Bu kılavuz, UCP’nin sağladığı yeteneklerden birini göstermektedir. UCP ayrıca kimlik bağlantısı ve sipariş yönetimi gibi diğer yetenekleri de destekler ve zengin tüketici ajan deneyimlerini desteklemek için genişlemeye devam edecektir.
Ayrıca, Python örnek uygulamasına gidip README.md dosyasını takip ederek kendiniz de deneyebilirsiniz.
3.0 Google ile Entegrasyon
Evrensel Ticaret Protokolü (UCP), tarafsız ve satıcıdan bağımsız olacak şekilde tasarlanmıştır ve herhangi bir yüzey veya platformda aracı tabanlı ticareti destekleyebilir. Somut bir örnek sunmak ve sorunsuz benimsemeyi desteklemek için Google, UCP’nin ilk referans uygulamasını geliştirmiştir. Bu uygulama, tüketicilerin Google’ın Arama’daki Yapay Zeka Modu ve Gemini gibi konuşma tabanlı deneyimlerinde uygun işletmelerden doğrudan satın alma yapmalarını sağlayan yeni bir satın alma deneyimini desteklemektedir.
Bu ödeme özelliği, tüketicilerin keşif aşamasından satın alma aşamasına sorunsuz bir şekilde geçmelerini sağlar. Protokol, mevcut ödeme ve cüzdan sağlayıcılarını destekleyecek şekilde tasarlandığından, Google’ın uygulaması, tüketicilerin Google Wallet’ta zaten sakladıkları ödeme ve gönderim bilgilerini kullanarak Google Pay ile güvenle alışveriş yapmalarını sağlayarak sürtünmeyi azaltır.
Örnek Sorgu: “Yaklaşan bir seyahat için hafif bir bavul bulun.”
Merchant Center aracılığıyla İşletme Entegrasyonu
UCP için Google uygulamasında yer almak için aktif bir Merchant Center hesabınızın olması ve ödeme için uygun ürünler sağlamanız gerekmektedir . Bu, Google’ın envanterinizi doğrudan etkileşimli deneyimler içinde satın alınabilecek şekilde görüntüleyebilmesi için gerekli ürün bilgilerine sahip olmasını sağlamak içindir.
Sonraki adımlar:
- Google entegrasyon kılavuzunu okuyarak Merchant Center hesabınızı kurun ve Google ile entegre olmak için satıcı ilgi formunu doldurun.
- Buradaki talimatları izleyerek UCP entegrasyonunu tamamlayın .
İşbirliği çağrısı
Evrensel Ticaret Protokolü, ekosistem genelinde 20’den fazla ortak tarafından birlikte geliştirilmiş ve onaylanmış açık kaynaklı bir projedir. Geliştiricileri, işletmeleri ve platform mimarlarını ticaretin geleceğini inşa etmede bize katılmaya davet ediyoruz ve geri bildirimlerinizi bekliyoruz. GitHub depomuzdaki spesifikasyonu inceleyerek, GitHub Tartışmalarına katılarak ve çekme istekleriyle katkıda bulunarak bugün siz de dahil olabilirsiniz.
