İçeriğe geç

POS entegrasyonu: MekanBook Connector API

MekanBook'ta misafirler masadaki QR ile sipariş verir, hesabı bölüşür ve öder. Restoranın kullandığı POS / adisyon programı hangisi olursa olsun bu akışa bağlanabilsin diye açık bir API sunuyoruz. POS firmanız veya restoranın BT ekibi aşağıdaki belgelerle bağlantıyı birkaç günde kurabilir.

Neler yapılabilir?

  • Siparişleri çekin: masadan gelen ve kabul edilen siparişler (ürün, adet, seçenekler, not, masa) GET /api/pos/v1/orders. Onaylanana kadar tekrar gelir; kayıp olmaz.
  • Mutfak durumunu gönderin: hazırlanıyor / hazır / servis edildi / iptal POST /lines/{id}/status. Misafir uygulamasında anında görünür.
  • Menü ve fiyatları eşitleyin: PUT /menu. Fiyat değişiklikleri kayda geçer; açık adisyonlardaki fiyatlar değişmez (sürpriz fiyat yok).
  • Kasada alınan ödemeyi bildirin: nakit veya kart POST /tables/{masa}/payments. Misafirin uygulamadaki hesabı güncellenir, aynı tutar iki kez alınmaz.
  • Açık adisyonları görün, kapatın: GET /tables, POST /checks/{id}/close.
  • Anlık bildirim: çekmek yerine itme isterseniz imzalı webhook.

Güvenlik

Her restoran bağlantısı için ayrı API anahtarı ve imza sırrı (restoran panelinden üretilir, yalnız bir kez gösterilir). Her istek HMAC-SHA256 ile imzalanır; 5 dakikadan eski ve tekrar edilen istekler reddedilir. Bir anahtar yalnız kendi restoranının verisine erişir. Deneme (sandbox) modunda yazma işlemleri gerçek adisyonu değiştirmez.

Belgeler

İş ortaklığı ve test restoranı için: iletişim.

Bağlantı durumu

  • Adisyo — doğrudan bağlantı
  • SambaPOS — doğrudan bağlantı
  • Simpra — Connector API ile bağlanabilir
  • robotPOS — Connector API ile bağlanabilir
  • Menulux — Connector API ile bağlanabilir
  • Paket Taxi — Connector API ile bağlanabilir
  • Dijital Adisyon — Connector API ile bağlanabilir
  • Mikro (Hızlı Satış) — Connector API ile bağlanabilir
  • Logo — Connector API ile bağlanabilir
  • Sepettakip — Connector API ile bağlanabilir
  • Siparişmatik — Connector API ile bağlanabilir
  • Restoran Pro — Connector API ile bağlanabilir