Bloga Dön
18 dk okuma

KOBİ ve Zincir Markalar için Dijital Sadakat Sistemi Entegrasyon Kılavuzu

Loyalisa platformunun ilk kurulumu, Apple ve Google Wallet şablonlarının tescili, POS yazılımı entegrasyonu ve barista terminali kullanımı.

Ankara Yazılım Ekibi

Yazar

Yayınlanma 29.05.2026
KOBİ ve Zincir Markalar için Dijital Sadakat Sistemi Entegrasyon Kılavuzu
Paylaş

Giriş: Dijital Sadakat Dönüşümüne Hazırlık

Bu rehber, Ankara Yazılım Loyalisa platformunu satın alan veya entegre etmek isteyen KOBİ'ler, zincir restoranlar, kafeler ve mağaza yöneticileri için hazırlanmıştır. Kurulum sürecini adım adım tamamlayarak müşterilerinize anında dijital sadakat kartları dağıtmaya başlayabilirsiniz.

Adım 1: Merchant Panel Kurulumu ve İlk Giriş

Satın alım sonrasında, Ankara Yazılım ekibi firmanıza özel bir yönetim paneli hazırlayarak ana yönetici bilgilerini tarafınıza iletir.

* Yönetim Paneli Girişi: Avustralya'daki markalar için panel.loyalisa.com, Türkiye'deki markalar için ankarayazilim.org/loyalisa/panel üzerinden giriş yapın.

* Şube Tanımlama: Ayarlar -> Şubeler menüsünden tüm fiziksel mağazalarınızı ekleyin. Her şube için isim, adres ve yerel koordinat bilgilerini girin.

* Çalışan Hesapları: Şubelerde kartları tarayacak barista ve kasiyerler için "Kasiyer" rolüne sahip kullanıcı hesapları oluşturun.

Adım 2: Apple ve Google Wallet Tasarımı ve Tescili

Müşterilerinizin telefonlarına ekleyecekleri dijital cüzdan kartlarının tasarımını yönetim panelinden tamamen özelleştirebilirsiniz.

Kart Tasarım Editörü

* Görsel Markalama: Firmanızın logosunu, şerit görsellerini ve arka plan renklerini yükleyin.

* Renk Şemaları: HSL tabanlı modern arayüz editörümüz sayesinde, markanıza en uygun renk geçişlerini ve kontrast ayarlarını saniyeler içinde uygulayın.

* Damga / Puan Ayarları: Kartın kaç damga ile tamamlanacağını (örneğin 8 veya 10 damga) ve hediye ödülün ne olacağını belirleyin.

* Dinamik Coğrafi İzinler: Müşteri cüzdan kartınızın arka yüzündeki yasal metinleri, Avustralya şubeleri için APP, Türkiye şubeleri için KVKK aydınlatma metinleriyle otomatik olarak eşleştirin.

Adım 3: Barista / Kasiyer Mobil Tablet Terminali Kurulumu

Şubelerdeki çalışanların müşterilerin dijital kartlarını hızlıca tarayabilmesi için Loyalisa Mobil Terminali kurulmalıdır.

Kurulum Adımları

  • Loyalisa Kasiyer: uygulamasını uygulama mağazasından indirin.
  • Uygulamayı ilk kez açtığınızda şube sorumlunuz tarafından oluşturulan kasiyer kullanıcı bilgileriyle giriş yapın.
  • Uygulama otomatik olarak şube kimliğinizi algılayacak ve terminalinizi senkronize edecektir.
  • Çevrimdışı Çalışma Güvencesi:: Kasiyer uygulaması, internet bağlantınız kopsa bile yerel şifreli Isar/SQLite veritabanı sayesinde kart taramaya devam etmenizi sağlar. Bağlantı geldiğinde sistem tüm verileri otomatik olarak cloud sunucusuna aktaracaktır.
  • Adım 4: Kurumsal POS Entegrasyonu (REST API & Idempotency)

    Büyük zincir mağazalarda, sadakat işlemlerinin mevcut yazar kasa veya POS sistemleriyle entegre çalışması istenir. Loyalisa, kurumsal POS entegrasyonu için gelişmiş REST API yolları sunar.

    POS API Akışı

    * Endpoint: POST /v1/pos/stamp

    * Gerekli Başlıklar:

    - Authorization: Bearer

    - Idempotency-Key: (Mükerrer damga vurulmasını engellemek için zorunludur).

    * İstek Gövdesi (Request Body):

    json
      {
        "cardId": "card_melbourne_cafe_001",
        "stampsDelta": 1,
        "rotatingToken": "584920",
        "terminalId": "melbourne_term_01"
      }

    * Güvenlik Doğrulaması: Sunucu, taratılan barkodun dynamic TOTP imzasını (rotatingToken) doğrular, idempotency anahtarını kontrol eder ve işlemi onaylayarak dijital cüzdana anında push bildirimi tetikler.

    Adım 5: Kampanya Dağıtımı ve Müşteri Kazanımı

    Kurulumlar tamamlandıktan sonra, müşterilerinizin kartları telefonlarına eklemesi için şu yöntemleri kullanabilirsiniz:

    * Masaüstü QR Kodları: Şube masalarına veya kasa yanına yerleştireceğiniz şık stantlardaki QR kodlar vasıtasıyla müşteriler kartları saniyeler içinde telefonlarına ekler.

    * SMS Dağıtım Geçidi: Mevcut numara listenize Twilio (Avustralya) veya NetGSM (Türkiye) entegrasyonlarımız üzerinden tek tıkla dijital kart ekleme bağlantısı gönderebilirsiniz.

    * Demo Otomatik Giriş: Kampanyayı denemek isteyen potansiyel müşteriler için ankarayazilim.org/loyalisa/demo?autologin=true adresini paylaşarak mock şubeler üzerinden sistemi anında test ettirebilirsiniz.

    Sık Sorulan Sorular

    Dijital sadakat kartları internet olmadan çalışır mı?

    Evet. Apple Wallet ve Google Wallet yerel cüzdan uygulamalarıdır, internet bağlantısı olmasa bile kart ekranda açılır. Kasiyer terminali de çevrimdışı çalışarak işlemi kuyruğa alır ve bağlantı geldiğinde otomatik eşitler.

    Bir müşteri ekran görüntüsü paylaşarak birden fazla hediye kazanabilir mi?

    Hayır. Barkodlar TOTP algoritmasıyla 60 saniyede bir dönen kriptografik imzalarla yenilenir. Alınan ekran görüntüsü süresi dolduğu için tarayıcı tarafından geçersiz kılınır.

    Müşteri verilerimiz KVKK mevzuatına uygun şekilde saklanıyor mu?

    Evet. Türkiye şubelerinizden toplanan tüm müşteri verileri İstanbul'daki yerel veri merkezlerimizde şifreli olarak barındırılır. Avustralya şubelerinizin verileri ise AWS Sydney veri merkezlerinde izole edilmiştir. Veri ihlallerine karşı 7/24 otomatik uyumluluk denetçisi aktiftir.

    Tags:Kullanım KılavuzuRehberEntegrasyonLoyalisaApple WalletGoogle Wallet