HandyCafe Docs
owner

Müşteri Menüsü

Müşteri menüsü, handy.cafe/{your-slug} adresindeki herkese açık web sayfasıdır. Müşteriler bu sayfaya masalarındaki QR kodu tarayarak ulaşır. Bu sayfa, personeli bilgilendirebilmeniz ve yaygınlaştırma planı yapabilmeniz için müşteri akışını baştan sona anlatır.

URL Yapısı

Her masanın handy.cafe/{cafe-slug}/{table-code} biçiminde benzersiz bir URL'si vardır. QR kodu, bu URL'nin yanında etiketin gerçek olduğunu kanıtlayan kısa ömürlü bir belirteç içerir. Müşteri QR'ı taradığında:

  1. Telefonu URL'yi varsayılan tarayıcıda açar.
  2. Sayfa slug ve masa kodunu bulut API'si üzerinden çözer.
  3. Masa out_of_order durumundaysa kullanılamaz uyarısı gösterir.
  4. Masa idle durumundaysa sayfa, personelin müşteriyi henüz oturtmadığını açıklar ve yardım çağırmasını ister.
  5. Masa in_use durumundaysa sayfa 6 haneli güvenlik kodunu ister.

Güvenlik Kodu Doğrulaması

Güvenlik kodu, yalnızca masada oturan müşterinin sipariş verebilmesini sağlar. QR'ı bir fotoğrafta gören ya da kafenin dışından bakan birinin sahte sipariş vermesini engeller.

Müşteri kodu girdikten sonra:

  1. API, kodu masada saklanan hash'lenmiş değerle doğrular.
  2. Geçerliyse bir oturum oluşturulur ve bir belirteç döndürülür.
  3. Belirteç bir çerezde (hc_menu_session) saklanır. Cihazın yerel depolamasına bir Bearer token yedeği de yazılır. Bu, bazı yapılandırmalarda üçüncü taraf çerezlerini engelleyebilen iPhone Safari için gereklidir.
  4. Müşteri menüye yönlendirilir.

Oturum 24 saat boyunca geçerlidir. Müşteri tarayıcıyı kapatıp aynı cihazdan geri dönerse oturum yine çalışır ve yeniden doğrulama yapmadan tekrar girebilir.

Diller

Menü 24 dili destekler: Arapça, Almanca, Yunanca, İngilizce, İspanyolca, Farsça, Fransızca, Hintçe, Endonezce, İtalyanca, Japonca, Korece, Malayca, Lehçe, Portekizce, Rumence, Rusça, Tayca, Tagalog, Türkçe, Ukraynaca, Urduca, Vietnamca ve Çince.

İlk ziyarette sayfa, tarayıcının Accept-Language başlığını inceler ve en uygun eşleşmeyi seçer. Müşteri, menünün üst kısmındaki seçiciyle dili dilediği zaman değiştirebilir. Seçilen dil oturum için hatırlanır.

Ürün adları, açıklamalar ve içerikler otomatik çevrilmez; menü düzenleyicisinde hangi dilde girdiyseniz o şekilde görünür. "Sepete Ekle", "Ödeme" ve ödeme akışı mesajları gibi arayüz etiketleri tamamen yerelleştirilir.

Tema

Menü açık tema ve koyu tema destekler. Varsayılan davranış cihaza duyarlıdır: müşteri işletim sistemini koyu moda ayarlamışsa menü de koyu modda açılır. Üst kısımda bir tema anahtarı müşterinin geçiş yapmasını sağlar.

Markalı Başlık

Menünün üst kısmındaki başlıkta şunlar gösterilir:

Öğe Kaynak
Başlık Görseli Ayarlar > Kafeterya üzerinden yüklenen görsel (isteğe bağlı)
Logo Ayarlar > Kafeterya üzerinden yüklenen logo
Görünen Ad İşletme profilinizden gelir
Adres İşletme profilinizden gelir (alt bilgide gösterilir)
Telefon İşletme profilinizden gelir (alt bilgide gösterilir)

En iyi müşteri algısı için bu alanları özelleştirin. Menü mekanınızın fiziksel tabelası gibi göründüğünde müşteriler markayı daha kolay tanır.

Menüde Gezinme

Menü kategorilere göre gruplanır. Her kategoride ürünler küçük görsel, ad, kısa açıklama ve fiyatla gösterilir.

Bir ürüne dokunduğunuzda ürün sayfası açılır. Bu sayfada şunlar bulunur:

  • Tam fotoğraf.
  • Markdown açıklaması.
  • İçerik satırı.
  • Menüde Hazırlık Süresini Göster açıkken görünen hazırlık süresi rozeti.
  • Yapılandırılmışsa birim etiketi (örneğin "250 ml").
  • Ürünle ilişkili her varyant grubu için seçim alanları.
  • Miktar artırıcı.
  • Sepete Ekle düğmesi.

Zorunlu varyant grupları, müşteri bir seçenek seçene kadar Sepete Ekle düğmesini engeller.

Sepet

Sepet simgesi kalıcı bir konumda durur; böylece müşteri her ekrandan ulaşabilir. Sepet içeriği site içi gezinme boyunca korunur; sepetten menüye gidip geri dönmek öğeleri silmez.

Sepet müşteriye şunları yapma imkanı verir:

  • Satır başına miktar ayarlama.
  • Bir satırı kaldırma.
  • İsteğe bağlı not ekleme.
  • Telefon numarası girme (isteğe bağlı).

Ara toplam, KDV ve toplam gerçek zamanlı olarak gösterilir.

Siparişi Verme

Ödeme adımı, yapılandırmanıza bağlı olarak bir veya iki ödeme yöntemi sunar:

Nakit

Çevrimiçi ödeme ayarlarda kapalıysa yalnızca Cash görünür. Müşteri siparişi onaylar ve sipariş hemen gönderilir. Müşteri sipariş geldiğinde kasaya ödeme yapar.

Çevrimiçi (Stripe Checkout)

Çevrimiçi ödeme açıksa Online bir seçenek olarak görünür. Gönderim sırasında:

  1. Sipariş beklemede durumunda oluşturulur.
  2. Bir Stripe Checkout client secret döndürülür.
  3. Stripe gömülü arayüzü sayfa içinde açılır. Müşteri kart bilgilerini girer.
  4. Yetkilendirme başarılı olursa Stripe tahsilatı onaylar ve sipariş paid durumuna geçer.
  5. Müşteri başarı sayfasını görür.

Başarısız ya da yarıda bırakılmış ödemeler siparişi beklemede bırakır. Aynı oturumdan ikinci bir deneme yapılabilir veya personel siparişi Orders panelinden iptal edebilir.

Başarı Sayfası

Başarılı gönderimden sonra müşteri bir fiş sayfasına ulaşır. Bu sayfada şunlar gösterilir:

  • Sipariş numarası ve zamanı.
  • Miktar, varyantlar ve satır toplamı ile her satır.
  • Ara toplam, KDV ve genel toplam.
  • Ödeme yöntemi.
  • Ödeme durumu simgesi (nakit için pending; çevrimiçi için paid).
  • Menüyü oturum korunarak geri getiren "Bir Sipariş Daha Ver" çağrısı.
  • "Menüye Dön" bağlantısı.

Sipariş Durumu Yoklaması

Gönderimden sonra müşterinin sipariş görünümü, mutfaktaki güncellemeleri yansıtmak için durum uç noktasını yoklar. Personel bir öğeyi preparing durumundan ready durumuna geçirirse, müşteri satırdaki rozetin birkaç saniye içinde güncellendiğini görür.

Bu, tezgahtan teslim alınan self servis siparişler için çok kullanışlıdır. Müşteri, menü sipariş hazır diyene kadar masada rahatça bekleyebilir.

Müşteriler Ne Yapamaz

  • Müşteriler güvenlik kodu olmadan menüye göz atamaz. Doğrulama adımı her zaman gerekir.
  • Müşteriler idle veya out_of_order durumundaki masalar için sipariş veremez.
  • Müşteriler sipariş gönderildikten sonra onu düzenleyemez veya iptal edemez. İptal işlemi Orders panelinden personel tarafından yapılır.

Temiz Bir Müşteri Deneyimi İçin İpuçları

  • Kafe adı ve "Taratıp sipariş verin. Kod için personele sorun." gibi net bir yönerge içeren QR etiketleri basın. Aksi halde müşteriler doğrulama adımını kaçırabiliyor.
  • Kategori ve ürün adlarını kısa tutun. Uzun adlar mobilde satır taşır ve görselleri aşağı iter.
  • Her ürün için en az bir fotoğraf yükleyin. Görsel ağırlıklı menüler, yalnızca metin tabanlı menülere göre daha iyi dönüşür.
  • Menüde Hazırlık Süresini Göster ayarını, dinamik tahmininiz eğitimini tamamladıktan sonra açın. İlk 30 gün boyunca statik değer çok cömert ya da çok sıkı olabilir ve müşteriler bunu fark eder.
  • Müşterilere açmadan önce tüm akışı kendi telefonunuzla test edin. Gerçek bir QR tarayın, kodu girin, test siparişi verin ve siparişin panelde göründüğünü doğrulayın.