Genel bakış

Bu genel bakışta, Sipariş Verme Uçtan Uca akışı ve sipariş karşılama web hizmetinizle nasıl etkileşime girdiği özetlenmektedir.

Sıralama

Sipariş Verme Uçtan Uca kullanıcı arayüzü, restoran tarafından sunulan hizmetlere bağlı olarak kullanıcı siparişine menü öğeleri eklerken ve teslim alma veya adrese teslim seçeneğine karar verirken kullanıcıyla olan tüm etkileşimleri yönetir. Bu deneyim, veri feed'lerinizde bulunan Restaurant, Service ve Menu varlıkları tarafından desteklenmektedir.

Sonraki adımda, kullanıcı tarafından oluşturulan Cart sonucunun web hizmetiniz tarafından işlendiği alışveriş sepeti doğrulama aşamasıdır.

Ödeme İşlemi

Ödeme işlemi, Google tarafından web hizmeti uç noktanıza yapılan ilk çağrıdır. Cart öğesinin doğrulanmasından web hizmetiniz sorumludur. Öğelerin stok durumunu ve fiyatlandırmasını onaylamanız, iade vergilerini, indirimleri ve ücretleri hesaplayıp iade etmeniz ve sipariş teslimat adresini doğrulamanız gerekir.

Ödeme süreci şu sıralamayı izler:

1. Sipariş Verme Uçtan Uca hizmeti, istek karşılama web hizmeti uç noktanıza Cart içeren bir CheckoutRequestMessage gönderir.
2. Web hizmetinizin, Cart içindeki öğeleri geçerli fiyatlar, müsaitlik durumu ve servis sağlayıcılara göre doğrulaması gerekiyor. Daha sonra indirimler, vergiler ve teslimat ücretleri dahil olmak üzere toplam fiyatı hesaplarsınız.
3. Uç noktanız, başarılı istekler için değiştirilmemiş Cart içeren bir CheckoutResponseMessage ile yanıt verir. İşleme hatası oluşturmak veya gerekirse küçük değişiklikler önermek için CheckoutResponseMessage öğesine bir FoodErrorExtension eklenebilir.

Uyarı: Tüm Ödeme İşlemi çağrıları siparişle sonuçlanmaz. Durumu, Ödeme İşlemi çağrılarına dayalı olarak korumayın.

Cart doğrulandıktan sonra kullanıcı, akışın sipariş gönderme aşamasına geçebilir.

Sipariş Gönderme İşlemi

Sipariş gönderme işlemi, kullanıcı siparişini verdiğinde tetiklenir. Web hizmetinizin alışveriş sepetini yeniden doğrulaması, online ödemeler etkinse kart jetonunu işlemesi ve son olarak siparişin durumunu güncellemesi gerekir.

Sipariş gönderme süreci şu sırayı izler:

1. Siparişleme Uçtan Uca hizmeti, istek karşılama web hizmeti uç noktanıza Order içeren bir SubmitOrderRequestMessage gönderir. Devam etmeden önce arka ucunuzun başka bir Cart doğrulaması gerçekleştirmesi gerekiyor.

2. Web hizmetiniz, Order içinde bulunan ödeme ayrıntılarını genellikle aşağıdaki işlemleri gerçekleştirerek işler:

   1. Jeton doğrulaması, sahtekarlık ve diğer uygunluk kontrollerini gerçekleştirme.
   2. Kartı yetkilendirin ve isteğe bağlı olarak ödeme alın.

3. Uç noktanız, CREATED ("Sipariş verildi" satın alma durumu), CONFIRMED ("Kabul edildi" satın alma durumu) veya REJECTED ("Reddedildi" satın alma durumu) içeren OrderUpdate içeren bir SubmitOrderResponseMessage ile yanıt verir.

Sipariş verildiğinde, kullanıcı hem sizden hem de Sipariş Verme Uçtan Uca kullanıcı arayüzünden sipariş durumu güncellemeleri almayı bekler. Kullanıcıya bir sipariş onayı e-postası göndermeniz gerekir. Ayrıca, Google'a ilgili sipariş güncellemelerini göndermek için Asenkron Sipariş Güncelleme API'sini de kullanırsınız.

Eşzamansız Sipariş Güncelleme İşlemi

Tarafınızdan gönderilen kullanıcı bildirimlerinden bağımsız olarak, aşağıdaki etkinlikler için Google'a sipariş durumu güncellemeleri de göndermeniz gerekir:

1. OrderState üzerinde yapılan değişiklikler (örneğin, CREATED - CONFIRMED ve CONFIRMED - IN_TRANSIT) arasındaki geçişler.
2. Fiyat veya stok durumu gibi sipariş öğelerinde yapılan değişiklikler.
3. Kullanıcı, müşteri destek kanallarınızın birinden destek isteği tetiklediğinde.

Güncellemeler, web hizmeti uç noktanızdan OrderUpdate içeren bir AsyncOrderUpdateRequestMessage olarak gönderilir. Google, AsyncOrderUpdateResponseMessage ile yanıt verir.

Sıra diyagramı

Aşağıdaki çizim, sipariş karşılama işlemlerinin web hizmetinizle nasıl etkileşimde bulunduğunu göstermektedir. Büyütmek için tıklayın.

Karşılama uç noktanızı ayarlayın

Sipariş Verme Uçtan Uca işlemleri, web hizmetinizle iletişim kurmak ve yemek siparişlerinin işlenmesi, onaylanması ve güncellemelerini yapmak için JSON mesajlarını kullanır. Sipariş Verme Uçtan Uca web hizmetinizi tasarlarken Sipariş Verme Uçtan Uca hizmetinden istek mesajları alan ve mesajları Google hizmetine geri döndürebilen bir URL uç noktası tanımlamanız gerekir. Uygulamanız aşağıdaki şartları karşılamalıdır:

• Web hizmetiniz, Sipariş Verme Uçtan Uca hizmetinden POST isteği olarak bir JSON mesajı alabilmelidir.
• Web hizmetiniz, Actions Center'da belirttiğiniz ve sipariş karşılama URL'si adlı, herkesin erişebileceği bir URL uç noktası sağlamalıdır. Sipariş karşılama URL'si, ödeme yapmak ve sipariş göndermek için kullanılır. Uygulamanız her iki istek türünü de işlemelidir.
• Web hizmetinizin, Google'dan gelen mesajları İleti doğrulama yöntemini kullanarak doğrulayabilmesi gerekir.
• URL uç noktası uygulamanız, tek bir uç noktayla hem ödeme hem de sipariş karşılama işlemlerini işleyebiliyor olmalıdır. Ödeme için bir URL uç noktanız ve sipariş gönderimi için ayrı bir uç noktanız olamaz.

İstemci Kitaplıkları

Araçlar bölümündeki istemci kodu oluşturma aracı, web hizmetinizi karşılama API'si spesifikasyonuna göre doğrulamak için kullanılabilir.