Kupon Kodları
Kupon kodu doğrulama, misafirlere önceden oluşturulmuş kodlar aracılığıyla internet erişimi sağlar. Otel resepsiyonları, konferanslar ve kafeler gibi ön yüz personeliyle birebir temas gerektiren ortamlarda yaygın olarak kullanılır. Telefon numarası veya e-posta adresi gerekmez.
Kupon Türleri
| Tür | Açıklama | Örnek Kullanım |
|---|---|---|
| Tek kullanımlık | Bir kez kullanıldıktan sonra geçersiz olur | Konferans katılımcı paketi |
| Çok kullanımlık | Kullanım sınırına ulaşılana kadar kullanılabilir | Aile odası kodu |
| Süreli | Geçerlilik bitişi tarihinden sonra geçersiz olur | Hafta sonu paketi |
Türler birleştirilebilir: örneğin "5 kullanımlık, 3 gün geçerli" bir kupon oluşturulabilir.
Her kuponun ayrıca bir Oturum süresi (dk) değeri vardır (5–10.080 dakika). Bu değer kuponla verilen erişimin süresidir; hesap genelindeki misafir internet süresini (varsayılan 8 saat) uzatamaz, yalnız kısaltabilir. Kuponun oturum süresi dolduğunda cihaz kod sorulmadan yeniden bağlanmaz; misafirin kupon kodunu yeniden girmesi gerekir.
Kupon Oluşturma
Konsol Arayüzü
Captive Portal → Voucher (Kupon) ekranındaki Yeni kupon bölümünde şu alanları doldurup Kupon oluştur'a basın:
- Kupon kodu — kodu siz belirlersiniz (4–64 karakter); kod büyük harfe çevrilerek kaydedilir
- Kullanım sınırı — 1–100.000
- Oturum süresi (dk) — 5–10.080
- Geçerlilik bitişi — boş bırakılırsa kupon süresizdir
- Operasyon notu — etkinlik, grup veya oda bilgisi gibi
Kodlar otomatik üretilmez; çok sayıda kupon için CSV içe aktarmayı kullanın.
Toplu İçe Aktarma (CSV)
Dışarıda üretilmiş kodları CSV içe aktar düğmesiyle yükleyebilirsiniz:
code,max_uses,ttl_minutes,valid_until,notes
HOTEL2026,10,480,2026-12-31T23:59:00+03:00,Misafir odası 101
CONF-ABCD,1,240,2026-06-15T18:00:00+03:00,Stant B12
VIP-SUITE,50,60,,Süit misafirleri
max_uses boş bırakılırsa 1, ttl_minutes boş bırakılırsa 60 dakika kabul edilir. valid_until ISO 8601 tarih/saat biçiminde yazılır; boş bırakılırsa kuponun süresi dolmaz.
Misafir Ekranı
Misafir portalda kupon kodunu girip Bağlan'a basar; kod geçerliyse portal misafiri ağ geçidine otomatik olarak yönlendirir. Kod bulunamazsa, süresi dolmuşsa veya kullanım sınırına ulaşılmışsa misafir Kupon kodu geçersiz veya kullanılmış. uyarısını görür.
Yarış Koşulu Güvenliği
Aynı kupon kodu aynı anda birden fazla cihazda girilirse kullanım sayacı veritabanında tek adımda (atomik) artırılır; bu sayede Kullanım sınırı aşılamaz.
:::info Teknik Detay Kupon kodları hesap içinde benzersizdir; aynı kod ikinci kez oluşturulmaya çalışılırsa hata verilir. :::
Kupon Durumu
Kupon listesindeki Durum sütunu kullanım sayısına ve geçerlilik bitişine göre hesaplanır:
| Durum | Açıklama |
|---|---|
| Aktif | Kullanım sınırına ulaşılmamış, geçerlilik bitişi geçmemiş |
| Tükendi | Kullanım sınırına ulaşıldı |
| Süresi doldu | Geçerlilik bitişi geçti |
Listede ayrıca kullanım sayısı, oturum süresi, geçerlilik bitişi ve son kullanım zamanı görünür. Kullanımı sıfırla kuponun kullanım sayısını sıfırlar; Kuponu sil kuponu kaldırır.
Raporlama ve Dışa Aktarma
Kupon listesi Captive Portal → Voucher (Kupon) ekranından CSV olarak dışa aktarılabilir. Toplam, kullanılabilir ve tükenen kupon sayıları ile kapasite kullanımı Raporlar → Voucher Performansı ekranında izlenir.
Kullanım Senaryoları
- Oteller — Resepsiyonda her konuğa verilen, odaya özel kupon.
- Konferanslar — Katılımcı paketinde basılı, tek kullanımlık kupon.
- Kafeler ve restoranlar — Kasada müşteriye verilen, kısa oturum süreli kupon.
Sorun Giderme
Kod Çalışmıyor
- Kodun doğru yazıldığını kontrol edin; büyük/küçük harf fark etmez, girilen kod otomatik olarak büyük harfe çevrilir.
- Kuponun Durum sütununda Tükendi veya Süresi doldu görünmediğini Captive Portal → Voucher (Kupon) ekranından doğrulayın; gerekirse Kullanımı sıfırla ile kullanım sayısını sıfırlayın.
- Kupon yönteminin Captive Portal → Misafir Auth Metotları ekranında açık olduğunu kontrol edin.
CSV İçe Aktarma Hatası
CSV dosyasının UTF-8 kodlamasında kaydedildiğinden ve başlık satırının (code,max_uses,ttl_minutes,valid_until,notes) tam olarak eşleştiğinden emin olun. Hatalı satırlar içe aktarma raporunda belirtilir; geçerli satırlar yine de aktarılır.
:::warning Güvenlik Notu Kupon kodlarını herkese açık kanallarda (sosyal medya, e-posta listesi) paylaşmaktan kaçının. Ele geçirilen kodlar Kullanım sınırı dolana kadar kullanılabilir. :::