POS Entegrasyonları

Entegrasyonlar ayarlar sayfası, uygun bir HandyCafe sunucusunu bir Ödeal D2D terminaline bağlar. Kullanılabilirlik HandyCafe bulutu üzerinden denetlenir. Kafenin Ödeal kullanma izni yoksa menü ve sayfa tamamen gizlenir.

Başlamadan Önce

Etkin bir HandyCafe bulut aboneliğine, bir Ödeal üye iş yeri anahtarına ve bir Ödeal gizli anahtarına ihtiyacınız var. Ayrıca terminali Ödeal'in Cihazlarım alanında oluşturmanız gerekir. O terminale verdiğiniz adın tamamı, terminalin externalDeviceKey değeridir. Stage ortamıyla başlayın. Üretim ortamına ancak Ödeal, üretim kimlik bilgilerinizi ve geri çağırma (callback) kurulumunu onayladıktan sonra geçin.

Ödeal Yapılandırması

1. Ayarlar sayfasını açın ve Entegrasyonlar bölümünü seçin.
2. Ödeal Hesabı alanında Ödeal'in verdiği üye iş yeri anahtarını ve gizli anahtarı girin. HandyCafe bu değerleri doğrudan HandyCafe bulutuna gönderir. Değerler şifrelenir; yerel veritabanında saklanmaz ve bir daha görüntülenmez.
3. Bağlantı Testi düğmesini seçin. Yeni anahtarlar girilmişse HandyCafe, Ödeal API bağlantısını test etmeden önce bunları güvenli biçimde kaydeder. Bu test yalnızca Ödeal hesabını doğrular. Terminalin eşleştirildiğini veya çevrimiçi olduğunu kanıtlamaz.
4. Terminali ekleyin. Anlaşılır bir yerel cihaz adı girin. Ödeal cihaz adı (externalDeviceKey) alanına Ödeal'de oluşturduğunuz cihaz adını birebir girin. Ardından isteğe bağlı PaxID, ortam, ödeme bekleme süresi, müşteri ili, müşteri ilçesi, oturum KDV oranı ve sipariş KDV oranı bilgilerini girin.
5. POS Entegrasyonu Etkin seçeneğini açın ve Kaydet düğmesini seçin.
6. Terminal eşleştirmesini ve her iki tahsilat yolunu doğrulamak için Stage ortamında bir nakit fişi ile bir kart ödemesi tamamlayın.

Bu sürümde sunucu başına yalnızca bir etkin Ödeal terminali desteklenir. Böylece kasiyer terminal seçici kullanıma sunulana kadar bir ödemenin istenmeyen bir terminale yönlendirilmesi önlenir.

HandyCafe, yeni bir kimlik bilgisi çiftini bulut doğrulamadan önce terminal envanterini yerel olarak kaydeder. Ödeal'in kimlik bilgilerini reddetmesi terminal adını veya eşleştirme alanlarını silmez. Yeni kimlik bilgisi gereken bir terminal, bu bilgiler seçili ortamı için doğrulanana kadar pasif olarak saklanır.

Entegrasyonlar sayfası terminal envanterini doğrudan yerel SQLite veritabanından okur ve bulut yanıtını beklemeden gösterir. Yalnızca şifreli kimlik bilgisi durumu ve uzak sağlayıcı izni için bir bulut isteği gerekir.

Ödeal yapılandırmayı reddederse HandyCafe, Ödeal'in döndürdüğü açıklamayı gösterir. Kuruluş profili bulunamadı (organization profile not found) yanıtı, üye iş yeri ve gizli anahtar çiftinin seçili Stage veya Üretim ortamındaki bir kuruluşa ait olmadığı anlamına gelir.

Ödeme Davranışı

Etkin ödeme yöntemi nakit veya kart olduğunda; PC oturumu kapatma, konsol oturumu kapatma ve bağımsız sipariş kapatma işlemleri Ödeal'e tekillik korumalı (idempotent) bir sepet gönderir. Nakit, Ödeal'in belgelerinde tanımlı CASH ödeme seçeneğiyle gönderilir. Terminal nakit ödemeyi kaydeder ve kart tahsilat ekranını açmadan mali fişi veya e-Arşiv faturasını basar. Kart ise CREDITCARD olarak gönderilir; müşteri ödemeyi terminalde tamamlarken HandyCafe geri çağırma sonucunu bekler. Hem nakit hem kart içeren bir kapatma işleminde iki ödeme seçeneği de kendi tutarlarıyla gönderilir.

Kart ve üye iş yeri sözleşmesi destekliyorsa müşteri terminalde taksit seçeneği belirleyebilir. HandyCafe, bildirilen taksit sayısını yerel satış kaydıyla birlikte saklar. Yerel satış yalnızca Ödeal işlemi onayladıktan sonra kesinleşir. Onaydan sonra yerel kayıt başarısız olursa HandyCafe aynı gün içinde iptal talebinde bulunur. Başarısız bir iptal, elle mutabakat hatası oluşturur ve Ödeal işlem raporundan kontrol edilmelidir. Nakit ve kart dışındaki ödeme yöntemi türleri mevcut HandyCafe tahsilat akışıyla devam eder.

Testler ve Terminal İşlemleri

Bağlantı Testi yalnızca Ödeal üye iş yeri kimlik bilgilerini ve API erişimini doğrular. Fiş basmaz, karttan tahsilat yapmaz ve externalDeviceKey değerinin terminalle eşleştirildiğini kanıtlamaz.

Verilen D2D API belgeleri ayrı bir Test Fişi Bas veya Test Tahsilatı uç noktası tanımlamaz. Kabul testi Stage ortamında normal sepetlerle yapılır: önce bir nakit sepeti gönderip basılan fişi doğrulayın, ardından bir kart sepeti gönderip terminalde tek çekim veya taksitli bir işlem tamamlayın. Yalnızca Ödeal'in verdiği Stage test kartı bilgilerini kullanın.

Ödeal kabul senaryoları gün sonu ile son fişin yeniden basımını içerir ancak bunlar terminal işlemleridir. D2D bu işlemler için uzaktan API çağrısı belgelemediğinden HandyCafe bunları uzaktan çalıştırılan düğmeler olarak sunmaz.

Uzaktan Açma ve Kapatma

HandyCafe yöneticileri Ödeal'i kontrol panelindeki Admin > Admin Ayarları > POS Sağlayıcıları bölümünden yönetir. Genel anahtar ana kontroldür. Ülke varsayılanları TR gibi iki harfli ISO kodlarını kullanır. Kafe kontrolleri, tek bir lisans için Ödeal'i açıkça açabilir veya kapatabilir. Kafeye özel karar ülke varsayılanını geçersiz kılar. Kafe kararını sıfırlamak, o kafenin yeniden ülke varsayılanını izlemesini sağlar.

Karar sırası şöyledir: genel anahtar, kafeye özel karar, ardından ülke varsayılanı. Kapalı bir genel anahtar Ödeal'i her kafe için kapatır. Açıkça verilmiş bir kafe kapatma kararı, ülkesi açık olsa bile sayfayı gizler. Açıkça verilmiş bir kafe açma kararı, ülkesi varsayılan listede olmasa bile sayfaya izin verir. Erişimin kapatılması yeni sepet oluşturmayı anında engeller. Devam eden bir ödemenin ortada kalmaması için mevcut bekleyen işlemler yine de sorgulanabilir veya iptal edilebilir.

Sunucu, kullanılabilirliği HandyCafe bulutu üzerinden denetler ve başarıyla doğrulanan son ülke/kafe kararını önbelleğe alır. Sağlayıcı kataloğu, kimlik bilgisi geçersiz olduğunda yapılandırılmış bir error.code ile HTTP 200 döndürür. Masaüstü uygulaması bu yanıtı, kimlik bilgisini yenileyip yeniden deneyerek karşılar. Geçici bir kimlik doğrulama veya ağ hatası, etkin bir yönetici kararını kapalı olarak yorumlamaz; böylece Entegrasyonlar menüsü kararlı kalır. Daha sonra alınan başarılı bir yanıt, yöneticinin verdiği kapatma kararı dahil önbelleği anında günceller. Daha önce doğrulanmış bir karar yoksa; bilinmeyen bir kafe ülkesi, pasif abonelik veya devre dışı bırakılmış sağlayıcı sayfayı gizli tutar. Önbellekteki görünürlük kullanılsa bile yeni Ödeal işlemleri her zaman bulut tarafından yeniden yetkilendirilir. Eşitlenen kafe profilinde ülke bilgisi yoksa lisansta kayıtlı ülke kullanılır.

Güvenlik ve Kurtarma

Ödeal kimlik bilgileri HandyCafe bulutunda dağıtıma ait kasa anahtarıyla şifrelenir. Geri çağırma istekleri, yapılandırılan istek anahtarıyla veya Ödeal üye iş yeri ve gizli anahtar başlıklarıyla doğrulanır. Sepet referans kodları her sipariş veya oturum için sabittir. Aynı kapatma işlemini tekrarlamak ikinci bir tahsilat oluşturmaz.

Ödeal iptali yalnızca Ödeal'in aynı gün kuralları kapsamında, terminal gün sonu kapanışından önce yapılabilir. Bekleyen bir sepet, ödeme tamamlanmadan önce ayrıca kaldırılabilir. Ödeal D2D genel bir iade işlemi sunmaz. İptal süresi geçtiğinde Ödeal arka ofisini ve işlem raporunu kullanın.

Ödeal D2D belgelenmiş bir uzaktan Z raporu veya gün sonu işlemi sunmaz. Gün sonunu terminal üzerinde tamamlayın. HandyCafe mutabakat için işlem raporlarını okuyabilir ve Ödeal'den gelen geri ödeme (payback) bildirimlerini kaydeder.