Fırsat POS Partner API

1. Bu rehberdeki terimler

TerimAnlamı
İşletmeRestoran veya kafe firması. Bir işletmenin birçok şubesi olabilir.
Marka (venue)İşletmenin Fırsat'taki markası (ör. "Kahve Durağı"). API'de: venue.
Şube (branch)Markanın tek bir fiziksel lokasyonu (ör. "Kadıköy Moda"). Her kupon kullanımı bir şubede olur.
Bağlantı (connection)Bir işletme ile sizin POS'unuz arasındaki bağ. Eşleştirme kodunu claim ettiğinizde id'sini (connectionId) alırsınız.
Eşleştirme kodu (pairing code)İşletmenin size okuduğu 8 karakterlik, tek kullanımlık kod (ör. K7QM-4XTB). 15 dakika geçerlidir.
KuponMüşterinin Fırsat'tan satın aldığı şey: bir ürün paketi. Bir veya birden fazla kullanım hakkı olabilir.
KodKasiyerin yazdığı ya da okuttuğu şey: 6 haneli bir sayı veya bir QR kod.
Önizleme (preview)Bize "bu kupon ne, şu an burada kullanılabilir mi?" diye sormak. Hiçbir şey harcamaz.
Onay (confirm)Bize "kupon fişte, kullanıldı olarak işaretle" demek. Bir kullanım hakkı harcar.
Menü ürünü (menu item)İşletmenin Fırsat menüsündeki bir ürün (ör. "Latte"). 0199a3c2-… gibi bir id'si vardır.
Ürün eşleme (mapping)(Opsiyonel) Bize sizin hangi ürün id'nizin bizim hangi menü ürünümüzle aynı olduğunu söylemek.
Satış birimi (saleUnit)Fırsat'ın bu kullanım için işletmeye ödediği TL tutarı. Kasiyer bu tutarı "Fırsat" ödeme tipiyle kapatır; kupon satırları fişinizde daha az tutuyorsa o kadarını (7.3).