💳 Sanal POS (PayTR, İyzico, Param, Sipay & Banka POS) Kurulum Rehberi
Müşterilerinizin Masa QR Menüden veya Online Paket Mağazasından 3D Secure ile kredi kartı ödemesi yapabilmesi için aşağıdaki 4 adımı izleyin.
/yonetim > Entegrasyonlar & POS sekmesinde Sanal POS Sağlayıcısı menüsünden çalıştığınız kurumu (PayTR, İyzico, Param, Sipay veya Garanti BBVA, Yapı Kredi POSNET, Akbank/İş Bankası/Ziraat NestPay) seçin.
PayTR için: Mağaza Paneli > Bilgi sayfasından Mağaza No, Mağaza Parolası (API Key) ve Mağaza Gizli Anahtarı (Salt) değerlerini kopyalayın.
İyzico / Banka POS için: Üye İşyeri No, API Key / Terminal ID ve Secret / 3D Store Key bilgilerinizi kopyalayın.
Ödeme kuruluşunuzun panelindeki Bildirim URL / Callback URL alanına aşağıdaki adresi yapıştırın. Ödeme onaylandığında masa adisyonu otomatik kapanır.
Bilgileri girip "Sanal POS Bilgilerini Kaydet" butonuna bastığınızda QR Menüde Online Kredi Kartı seçeneği otomatik açılır. Gerçek çekim için Çalışma Modunu CANLI MOD (LIVE) yapın.
https://lezzet-pide.markobistro.com/api/payments/checkout🪙 Kripto Ödemelerde Otomatik Ödeme Onayı İçin API Alma ve Bağlama Rehberi
Müşterinin yaptığı kripto transferinin (USDT TRC20, BTC, ETH, SOL, BNB, TON) sistem tarafından otomatik doğrulanıp onaylanması ve masa hesabının otomatik kapanması için aşağıdaki 3 yöntemden biriyle API anahtarınızı alıp bağlayabilirsiniz:
- Binance hesabınıza giriş yapın ve sağ üstteki Profil İkonu > API Yönetimi (API Management) menüsüne tıklayın.
- "API Oluştur (Create API)" butonuna basın, Sistem Tarafından Oluşturulan (System Generated) seçeneğini seçip etiket olarak
MarkoBistro-POSyazın. - API Kısıtlamaları (Restrictions): Yalnızca "Okumayı Etkinleştir (Enable Reading)" kutucuğunu işaretli bırakın. (Para çekme veya alım-satım izni VERMEYİN; böylece anahtarınız %100 güvenlidir ve yalnızca cüzdanınıza ödeme gelip gelmediğini kontrol eder.)
- Ekranda oluşan API Key ve Secret Key kodlarını kopyalayın. (Kurumsal Binance Pay Merchant kullanıyorsanız
merchant.binance.com > Developers > API Keysmenüsünden alabilirsiniz.)
- nowpayments.io, coingate.com veya cryptomus.com üzerinde ücretsiz mağaza hesabı açın ve ödemelerin aktarılacağı kendi cüzdan adresinizi (Outcome Wallet) tanımlayın.
- Panelde Store Settings (Mağaza Ayarları) > API Keys bölümüne giderek yeni bir API Key oluşturun.
- Aynı sayfadaki IPN (Instant Payment Notification) Secret Key bölümünden gizli anahtarınızı oluşturun.
- IPN Callback / Webhook URL alanına aşağıdaki
/api/payments/cryptoadresinizi yapıştırın. Ödeme onaylandığı anda Marko Bistro'ya otomatik sinyal gelir!
- Borsa kullanmadan doğrudan TrustWallet, MetaMask, TronLink veya Ledger soğuk cüzdanınıza ödeme alıyorsanız blokzincir sorgulama API'si kullanabilirsiniz.
- USDT (TRC20) transferlerinin anlık sorgulanması için trongrid.io (ETH/ERC20 için etherscan.io, BNB/BEP20 için bscscan.com) üzerinden ücretsiz hesap açıp bir API Key oluşturun.
- Yönetim panelinde Ödeme Modu olarak "🔗 TronGrid / Etherscan Blokzincir API" seçip API Key ve cüzdan adresinizi kaydedin.
- Müşteri transferi gönderdiğinde sistem blokzincir ağından (On-Chain) cüzdanınıza gelen son transfer tutarını ve TxHash kodunu sorgulayarak otomatik onay verir.
/yonetim > Entegrasyonlar & POS içindeki Kripto kartında kullandığınız API yöntemini (Binance API, NOWPayments veya TronGrid On-Chain) seçin.
Aldığınız API Key, Secret Key ve ödeme kabul edeceğiniz cüzdan adreslerinizi (USDT TRC20, BTC, ETH, SOL, BNB, TON) yapıştırıp kaydedin.
Kartın altındaki "🧪 Kripto API & Otomatik Onay Bağlantısını Test Et" butonuna tıklayarak canlı kur ve API doğrulamasını kontrol edin.
Müşteri QR kodu okutup ödemeyi gönderdiğinde sistem API / Blokzincir üzerinden transferi doğrular, siparişi ÖDENDİ yapar ve kasaya gelir olarak işler!
https://lezzet-pide.markobistro.com/api/payments/crypto📟 Fiziki Yazar Kasa POS (Beko 300 TR, Hugin, Ingenico, Profilo) Bağlantı Rehberi
Masada veya kasada hesap kapatıldığında fiziki yazar kasa cihazınızdan otomatik mali fiş basılması ve kart çekimi yapılması için kurulum adımları:
Yazar kasa POS cihazınızı restoranınızdaki kasa bilgisayarı / tableti ile aynı yerel Wi-Fi veya Ethernet ağına bağlayın. Cihazın IP adresinin değişmemesi için modemden veya cihazın Ağ Ayarları menüsünden Sabit IP (Örn: 192.168.1.150) verin.
Beko 300 TR / Ingenico / Hugin cihazınızda Ayarlar > Bağlantı > Harici Uygulama / GMP3 Eşleştirme menüsünü açın. Cihazın ekranında yerel IP adresi ve Port (varsayılan: 4444 veya 8080) görünecektir.
/yonetim > Entegrasyonlar & POS sekmesindeki Yazar Kasa POS (ÖKC) kartından cihaz markanızı seçin, cihazın altındaki Mali Sicil No (Örn: BEK30019283) ve IP:Port bilgisini yazıp eşleştirin.
🛵 Yemeksepeti, Getir Yemek ve Trendyol Yemek Kurulum Rehberi
3 ayrı tableti takip etmek yerine tüm paket siparişlerinizi tek mutfak ve kurye ekranında toplayın, fiyatlarınızı komisyon farkıyla tek tıkla güncelleyin.
Yemeksepeti Partner Portalı > Entegrasyon / POS Ayarları bölümünden Vendor ID (Restoran Kodu) ve POS API Token bilginizi alın. Entegrasyonlar sekmesinde Yemeksepeti kartına girip komisyon farkı oranınızı (örn. %15) belirleyerek kaydedin.
GetirYemek Restoran Paneli > Ayarlar > API & Entegrasyon sayfasından Restaurant Secret Key ve App Secret Key bilgilerinizi kopyalayın. Marko Bistro Entegrasyonlar sekmesindeki Getir Yemek kartına yapıştırıp aktif edin.
Trendyol Yemek Partner Paneli > Hesap Bilgilerim > Entegrasyon Bilgileri sekmesinden Satıcı ID (Seller ID), API Key ve API Secret anahtarlarınızı alıp Trendyol Yemek kartına kaydedin.
https://lezzet-pide.markobistro.com/api/integrations/sync-menu🧾 GİB e-Fatura & e-Arşiv Entegrasyonu Kurulum Rehberi
Adisyon kapandığında veya paket sipariş tamamlandığında tek tıkla GİB onaylı e-Arşiv / e-Fatura kesmek için:
/yonetim > Entegrasyonlar & POS içindeki e-Fatura / e-Arşiv kartında "Mükellef Kaydı & Aktivasyon" butonuna tıklayın. İşletmenizin 10 haneli VKN (veya 11 haneli TCKN), Resmi Ticari Ünvan ve Vergi Dairesi/Adres bilgilerini girin.
Aktivasyon tamamlandıktan sonra Kasa veya Yönetim Panelinden hesap kapatılırken sistem otomatik olarak GIB2026... serili resmi faturanızı oluşturur ve PDF/SMS olarak müşteriye iletir.
👥 Hangi Personel Hangi Ekranı Kullanır? (Rol Bazlı Terminaller)
Marko Bistro'da her çalışan sadece kendi işiyle ilgili sadeleştirilmiş ekrana girer. Personellerinizin e-posta ve şifrelerini /yonetim > Personel / İK sekmesinden oluşturabilir veya güncelleyebilirsiniz.
Menü, reçete maliyeti, stok, ön muhasebe, kâr raporları, personel maaş/görev atama ve tüm entegrasyon ayarları.
/yonetimEkranı Aç ↗Tüm masaların doluluk durumu, adisyon detayları, parçalı/tam ödeme alma, kripto transfer onaylama ve masa taşıma.
/kasaEkranı Aç ↗Masalardan gelen garson/hesap çağrıları, hazır olan yemek bildirimleri, masaya hızlı sipariş girme ve fotoğraflı görevler.
/garsonEkranı Aç ↗İstasyon bazlı (Mutfak, Bar, Tatlı) canlı sipariş kartları, hazırlama süreleri ve 'Hazır' bildirimi gönderme.
/mutfakEkranı Aç ↗Hazır paket siparişleri teslim alma, tek tıkla Google Haritalar yol tarifi, müşteri arama ve kapıda tahsilat onayı (/sofor).
/kuryeEkranı Aç ↗Günlük kasa gelir/gider defteri, toptancı fatura girişi, hammadde birim maliyetleri ve finansal özet ekranı.
/muhasebeEkranı Aç ↗Yöneticinin atadığı günlük iş/hijyen görevlerini görme, fotoğraflı kanıt (~25 KB otomatik ufaltmalı) ve not ile tamamlama (/gorevler).
/personelEkranı Aç ↗Müşterilerin uygulama indirmeden masadan (/masa/masa-1) veya evden (/magaza) sipariş verdiği vitrin ekranları.
/magazaEkranı Aç ↗❓ Sıkça Sorulan Sorular (Genel Rehber)
İşletme sahiplerinin ve personellerin en çok sorduğu sorular ve pratik çözümleri:
Yönetim Paneli (/yonetim) > Entegrasyonlar & POS sekmesine gidin. Sağlayıcı listesinden kendi bankanızı (Garanti BBVA GVPS, Yapı Kredi POSNET, Akbank/İş Bankası/Ziraat NestPay) veya ödeme kuruluşunuzu (PayTR, İyzico, Param, Sipay) seçin. Bankanızın size verdiği Üye İşyeri No (Merchant ID), API Kullanıcı / Terminal No ve Gizli Anahtar (Store Key / Secret Key) bilgilerini girip 'Sanal POS Bilgilerini Kaydet' butonuna basın. Kaydettiğiniz anda QR Menü ve Online Paket Mağazasında 3D Secure kartla ödeme otomatik olarak aktif olur.