Sigorta Menüsü

Panelin sol menüsündeki Sigorta ürünü şu ekranları içerir:

Ekranları görmek için sigorta görüntüleme, değişiklik yapmak için sigorta yönetim yetkisi gerekir: Sağlayıcı Bağlantısı › Yetkiler.

Genel

Sigortanın açık olup olmadığını, hangi yüzeylerde sunulacağını ve poliçe sonrası davranışı yönetirsiniz. Değişiklikler kaydettiğinizde yeni tekliflere uygulanır; kesilmiş poliçeler etkilenmez.

Sigorta durumu

Sigorta açık ayarı varsayılan olarak kapalıdır. Kapalıyken hiçbir yüzeyde sigorta teklifi sunulmaz; bağlantılarınız ve ayarlarınız korunur, ödemeleriniz etkilenmez.

Kullanım modu

Sigortanın hangi yüzeylerde sunulacağını seçersiniz. Sigorta açıkken en az bir mod seçilmelidir.

• Seçili olmayan yüzeyde uygunluk listesi boş döner ve sigorta sunulmaz.
• API'de uygunluğu ödeme kimliğiyle (paymentIntentId) sorguluyorsanız API — Lunixi ödemesine bağlı modu seçili olmalıdır. Sepet kalemleriyle sorguda iki API modundan biri yeterlidir: Uygunluk.

Akışlar: Checkout Form Yolu, API Yolu.

Poliçe kesilemezse

Prim tahsil edildikten sonra poliçe kesin olarak kesilemezse ne olacağını Prim iadesini otomatik başlat ayarı belirler. Ayar varsayılan olarak kapalıdır.

Primi Lunixi dışında tahsil ettiyseniz iadeyi her durumda kendi kanalınızdan yapar ve bildirirsiniz: İptal ve Prim İadesi.

Alıcıya poliçe bildirimi

Bu ayar açıksa Lunixi alıcınıza şu durumlarda bildirim gönderir:

• poliçe kesildiğinde, belge bağlantısıyla,
• poliçe kesilemeyip prim iade edileceğinde,
• poliçe iptal edildiğinde.

Kurallar:

• Ayar varsayılan olarak kapalıdır. Kapalıyken alıcınızı siz bilgilendirirsiniz; bunun için webhook olaylarını kullanabilirsiniz.
• Bildirim E-posta kanalıyla, sigorta isteğinde iletilen alıcı e-posta adresine gönderilir. Ekranda görünen SMS kanalı şu an seçilemez.
• Bildirim yalnızca Canlı bağlantıyla kesilen poliçelerde gönderilir. Test bağlantısının siparişlerinde alıcıya bildirim gitmez.

Webhook olayları

Bu bölüm sigorta olaylarını ve hangi olaya kaç uç noktanızın abone olduğunu gösterir. Ortam seçimiyle test ve canlı uç noktalarınızı ayrı görürsünüz.

• Sigorta olayları, Hesabım > Webhooklar ekranında sigorta ürünüyle açtığınız uç noktalara gönderilir. Hangi olayın gideceğini uç noktanın abonelikleri belirler; bu ekranda ayrıca olay seçilmez.
• Kritik işaretli olaylar parasal sonucu olan olaylardır; bunlara abone olmazsanız bu sonuçları kaçırırsınız.
• Planınızda yok işareti, olayın planınızda bulunmadığını gösterir. Planınız o ortamda webhook gönderimini içermiyorsa ekranda uyarı görünür; olaylara abone olunsa da teslim edilmez.
• Webhook uç noktalarını yönet sizi Hesabım > Webhooklar ekranına götürür.

Olaylar ve abonelik: Webhook Olayları.

Sigorta Tipleri

Size açık sigorta tiplerini, her tipte kullanılan bağlantıları, gösterim önceliğini ve uygunluk kurallarını yönetirsiniz.

Tipler ve öncelik

Listede, sigorta bağlantılarınızdaki ürünlerin tipleri görünür. Henüz bağlantınız yoksa listede tip görünmez.

• Bir tip yalnızca açıksa sunulur. Tipler varsayılan olarak kapalıdır; sunacağınız tipi açıp kaydedin.
• Öncelik, bir sepette birden çok tip sunulduğunda tiplerin gösterim sırasıdır.
• Açık bir tipte, o tipte açık ürünü olan aktif bir bağlantınız yoksa satırda uyarı görünür ve tip sunulmaz. Ürünü bağlantı detayından açın.
• Kaydettiğinizde açık tipler ve sıraları yeni tekliflere uygulanır.

Aynı tip için hangi bağlantının önce kullanılacağı bu listede değil, bağlantıdaki ürünün sırasıyla belirlenir: Aynı tip için sağlayıcı sırası.

Uygunluk kuralları

Bir tipin hangi kalem tutarlarında sunulacağını sınırlarsınız. Kuralı olmayan kapsamda tutar sınırı yoktur.

• Tutar, kalemin bir biriminin teminat bedelidir: kalemde insuranceValueAmount varsa o, yoksa birim fiyatı. Tutarı ekranda ana para birimiyle yazarsınız (ör. 1250,50); en çok iki ondalık kullanılır. Alan: Sepet Kalemleri › Sigorta alanları.
• Aynı tip, yüzey ve para birimi için tek kural yazılır. En çok 200 kural yazabilirsiniz.
• Alt sınır üst sınırdan büyük olamaz.
• Kaydet listenin tamamını yazar: listeden kaldırdığınız kural silinir.

Platform kuralları bölümü, Lunixi'nin bütün işyerleri için uyguladığı kuralları salt-okunur gösterir. Bir kapsama uyan platform kuralının ve sizin kuralınızın hepsi sağlanmalıdır:

• Sizin kuralınız platform kuralını yalnızca daraltabilir. Aralığınız platform aralığının dışına taşıyorsa satırda uyarı görünür; geçerli olan iki aralığın kesişimidir.
• Platform bir tipi bir kapsamda kapatıyorsa sizin kuralınız tipi o kapsamda açamaz.

Kural sağlanmazsa o kalem için tip sunulmaz ve uygunluk listesi boş dönebilir: Uygunluk › Boş liste.

API Kullanımı

Sigortayı kendi arayüzünüzde API ile sunmak için gerekenleri tek ekranda toplar. Ekran salt-okunurdur; ayarlar Genel ve Sağlayıcı Bağlantıları ekranlarındadır.

Sigorta uçları yalnızca API anahtarınızla imzalanmış istekleri kabul eder; panel oturumu bu uçlarda geçerli değildir. Ayrıntılar: API Yolu, Test Ortamı.

İstekler

Sigorta isteklerinizi ve bağlantınızın sağlayıcıya yaptığı çağrıları izlersiniz. En yeni kayıt en üsttedir; kayıtlar 60 gün saklanır. Kişisel veriler maskelenmiş olarak gösterilir.

Liste

Süzgeçler

• Başlangıç ve Bitiş: tarih seçmezseniz son 7 gün gösterilir; aralık en çok 60 gün olabilir.
• Yüzey, Yön (Gelen istek ya da Sağlayıcı çağrısı) ve Uç.
• İstek kimliği: hata yanıtındaki requestId değeriyle o isteği bulursunuz.
• Sigorta siparişi: inso_ ile başlayan sipariş kimliği.
• Payment intent: ödeme kimliği (UUID).

İstek ayrıntısı

Bir satıra tıkladığınızda ayrıntı açılır:

• İstek ve yanıt (maskeli): Kart, kimlik bilgisi ve kişisel veriler kayda yazılmadan önce maskelenir; maskesiz değer saklanmaz.
• Doğrulama sonucu: İstek doğrulamada reddedildiyse reddedilen alanlar alan yolu ve nedeniyle listelenir. İstek hatayla bittiyse hata kodu ve yanıt gövdesi nedeni gösterir.
• Bu istekte sigorta sunulmadı: Uygunluk listesi boş döndüğünde görünür ve olası nedenleri sayar. Kontrol listesi: Test Ortamı › Sigorta sunulmuyorsa.
• Tekrar geçmişi ve sağlayıcı çağrıları: Aynı isteğin denemeleri, sağlayıcı çağrısını başlatan gelen istek ve isteğin bağlantınız üzerinden sağlayıcıya yaptığı çağrılar.
• İlgili sigorta siparişi: Siparişin genel durumu ve dört ekseni, poliçeleri ve arka plan işlemleri. Poliçe ekranında aç ile siparişi Poliçeler ekranında açarsınız; Bu siparişin istekleri listeyi o siparişe süzer.

Poliçeler

Sigorta siparişlerinizi ve poliçelerini izlersiniz: durum, sağlayıcı bağlantısı, tahsilat, belge, iptal ve prim iadesi.

Görünümler ve süzgeçler

Süzgeçler: Sigorta tipi, Poliçe durumu, Sipariş numaranız (en çok 128 karakter) ve Payment intent (UUID).

İade gerekiyor

Bu görünüm, iade durumu İade gerekiyor (REQUIRED), İade sürüyor (PENDING) ya da İade başarısız (FAILED) olan siparişleri listeler. Prim tahsil edildiği hâlde poliçe kesin olarak kesilemeyen sipariş, iadesi başlatılana kadar burada İade gerekiyor olarak görünür. İadeyi siparişin detayından başlatır ve sonucunu bu listeden izlersiniz: Prim iadesi.

Otomatik iadeyi açtıysanız Lunixi ödemesindeki primin iadesi kendiliğinden başlar: Poliçe kesilemezse.

Liste

Listede her satır bir sipariştir: oluşturma zamanı, poliçe numarası (birden çok poliçede ek poliçe sayısı), sigorta tipi, prim, sağlayıcı ve primi tahsil eden, payment intent, sipariş numaranız, poliçe ve iade durumu ile genel durum.

Durumlar

Panel, siparişin genel durumunu ve dört eksenini Türkçe etiketlerle gösterir. Etiketlerin API değerleri:

Durumların anlamı ve genel durumun eksenlerden nasıl çıktığı: Kavramlar ve Durumlar.

Poliçe detayı

Bir satıra tıkladığınızda detay açılır:

• Sipariş bilgileri: sigorta tipi, prim, sağlayıcı bağlantısı, primi tahsil eden, ödeme (Lunixi ödemesi ya da Lunixi dışında ödeme), payment intent, sipariş numaranız, kanal, sigorta siparişi ve teklif kimliği, iade zamanı.
• Poliçeler: Her sigortalı kalem için ayrı poliçe kesilir; her poliçede poliçe numarası ve sepet kalemi görünür.
• İşlemler: iptal talebi ve prim iadesi (aşağıda).
• Sipariş geçmişi: arka plan işlemleri (teklif oluşturma, ödeme bildirimi, poliçe kesimi, iptal, prim iadesi), deneme sayıları, durum geçişleri ve geçişi kimin yaptığı (Sistem, Alıcı, Siz, Platform ekibi, Sağlayıcı).

Sonucu bekleyen bir işlem varsa detay açıkken durum kendiliğinden yenilenir. Başarısız denemeler otomatik olarak tekrarlanır; sonuç belirsiz kalırsa işlem platform ekibinin incelemesine alınır, otomatik tekrar durur ve detayda bilgi notu görünür. Platform ekibinin işlemleri de geçmişte listelenir.

Poliçe belgesi

Poliçede PDF indir ile belgeyi indirirsiniz.

• Belge Lunixi'de saklanmaz; her indirmede sağlayıcıdan alınır.
• Belge, poliçe kesildikten sonra indirilebilir. İptal edilmiş poliçenin belgesi indirilemez.
• Sağlayıcı belgeyi o an veremiyorsa uyarı görünür. Poliçeniz geçerliliğini korur; biraz sonra yeniden deneyin.

API'de karşılığı: Poliçe Belgesi.

İptal talebi

İptal talebi gönder, siparişin kesilmiş bütün poliçeleri için sağlayıcıda iptal talebi açar.

• Yalnızca kesilmiş poliçede kullanılır (poliçe Kesildi ya da Kısmen kesildi).
• Talep sağlayıcı tarafından sonuçlandırılır ve geri alınamaz. Sonuç kesinleşene kadar poliçe İptal sürüyor görünür.
• İptal primi iade etmez. Gerekirse iptal sonrasında prim iadesini ayrıca başlatın.

Prim iadesi

Prim iadesini başlat yalnızca şu durumda kullanılır: primi siz tahsil ettiniz, prim tahsil edildi ve yürürlükte bir poliçe yok. Diğer durumlarda düğmenin yerine nedeni yazar:

İade, primin nasıl tahsil edildiğine göre yapılır:

• Lunixi ödemesiyle tahsil edilen prim: Prim tutarı, alıcının Lunixi ödemesinden kısmi iade olarak geri verilir. Sonuç bankadan gelir.
• Lunixi dışında tahsil edilen prim: İadeyi kendi kanalınızdan yapar, ardından İade kimliğiniz (boşluksuz, 1-128 karakter) ve İade zamanı ile bildirirsiniz. İade zamanı tarayıcınızın saat dilimiyle gönderilir; ödeme zamanından önce ve gelecekte olamaz.

İadenin başlatılması tamamlandığı anlamına gelmez. Sonucu İade ekseninden izleyin: İade sürüyor, İade edildi ya da İade başarısız. İade başarısız olduysa hata kodunu inceleyip İadeyi yeniden başlat ile yeniden deneyebilirsiniz.

API'de karşılığı: İptal ve Prim İadesi.

Mutabakat

Sağlayıcınızla mutabakat için bağlantı bazlı poliçe ve prim raporu alırsınız. Rakamlar sipariş kayıtlarından okunur.

Dönem ve süzgeçler

• Başlangıç ve Bitiş günü zorunludur. Dönem, siparişin oluşturulduğu güne göre İstanbul saatiyle kesilir; bitiş günü dahildir; en çok 366 gündür.
• İsteğe bağlı süzgeçler: Sağlayıcı bağlantısı, Sigorta tipi, Para birimi (üç harfli ISO kodu, ör. TRY).
• Durumlar raporu aldığınız andaki durumdur.

Özet

Özet; bağlantı, para birimi ve primi tahsil eden başına ayrı bir kart olarak gösterilir. Her kartta adet ve prim toplamı vardır:

Tahsilat ve iade ölçüleri sipariş, poliçe ölçüleri poliçe başınadır.

CSV dışa aktarımı

CSV indir, seçtiğiniz dönem ve süzgeçle rapor satırlarını indirir.

• Her poliçe bir satırdır. Sipariş sütunları siparişin her poliçe satırında tekrar eder; henüz poliçesi olmayan sipariş, poliçe sütunları boş tek satırdır.
• Tutarlar kuruş cinsindendir. Sipariş toplamı için orderPremiumAmountMinor değerini orderId başına bir kez toplayın; poliçe toplamı için policyPremiumAmountMinor değerini toplayın.
• Bir dosya en çok 20.000 sipariş içerir. Sınıra ulaşıldığında ekranda uyarı görünür; kalan siparişler için Devamını indir'i kullanın.
• Dışa aktarım yarıda kesilirse ekranda uyarı görünür ve indirilen dosya eksiktir; dosyayı yeniden indirin.

Durum sütunlarının değerleri Durumlar tablosundaki API değerleridir.

İlgili

• Sağlayıcı Bağlantısı: bağlantı, ürünler ve sıra
• Form Ayarları > Sigorta: Checkout Form'da sigortanın yeri
• Kavramlar ve Durumlar: sipariş durumları
• Webhook Olayları: sigorta olayları