Sigorta
Sigorta, alıcınızın satın aldığı ürüne aynı alışverişte sigorta eklemesini sağlar. Örneğin bilet satıyorsanız alıcınız bilete bilet iptal sigortası ekleyebilir. Bir ürüne bağlı olmayan sigortaları (ferdi kaza gibi) tek başına da satabilirsiniz.
Sigortayı sizin anlaştığınız sigorta sağlayıcısı sunar. Lunixi teklif, sipariş, poliçe ve takip altyapısını sağlar; sağlayıcınızla aranızdaki anlaşmaya göre çalışır.
İki kullanım biçimi
Sigortayı Lunixi ödemesiyle birlikte ya da Lunixi ödemesi olmadan, tek başına sunabilirsiniz. Ödemeyi nasıl aldığınıza göre birini seçin.
| Lunixi ödemesiyle | Yalnız sigorta | |
|---|---|---|
| Ne zaman | Ödemeyi Lunixi ile alıyorsunuz. | Ödemeyi Lunixi dışında alıyorsunuz ya da yalnızca sigorta satıyorsunuz. |
| Hesabınızda gereken | Ödeme ürünü ve sigorta ürünü | Yalnızca sigorta ürünü |
| Nasıl entegre olursunuz | Checkout Form: sigortayı panelden açarsınız, alıcı formda seçer. Ya da API ile: teklifi ve siparişi API'den alır, primi ödemenizin sepetine ayrı bir kalem olarak eklersiniz. | Yalnız API ile: teklifi ve siparişi API'den alır, primi kendi kanalınızdan tahsil edip bildirirsiniz ya da sağlayıcınıza çektirirsiniz. |
| Prim | Ürünle aynı çekimde alınır. | Sizin kanalınızda ya da sağlayıcının çekimiyle alınır. |
Sigortasız ödemeleriniz hiçbir biçimde etkilenmez. Sepette sigorta bilgisi yoksa sigorta sunulmaz ve ödeme her zamanki gibi devam eder.
Nereden başlamalı
| Ne yapmak istiyorsunuz | Sayfa |
|---|---|
| Sigortayı Lunixi ödemesi olmadan, yalnız API ile entegre etmek | Yalnız Sigorta Entegrasyonu |
| Sigortayı Lunixi'nin ödeme formunda sunmak | Checkout Form Yolu |
| Sigortayı kendi formunuzda, Lunixi ödemesiyle sunmak | API Yolu |
| Bütün uçları tek tabloda görmek | Uç Referansı |
| Sağlayıcınızı bağlamak ve ürünleri açmak | Sağlayıcı Bağlantısı |
| Sigorta tiplerinin alanlarını öğrenmek | Sigorta Tipleri ve Şemalar |
| Teklif bilgisini sepetle birlikte göndermek | Sepet bilgisi ve ön veri |
| Sigortayı denemek | Test Ortamı |
Nasıl çalışır
Sağlayıcınızı bağlayın
Lunixi panelinde, katalogda listelenen sağlayıcılar arasından anlaştığınız sağlayıcıyı bağlarsınız. Bağlantıda hangi sigorta ürünlerini sunacağınızı ve primi kimin tahsil edeceğini belirtirsiniz.
Sigorta sepete göre belirlenir
Hangi sigortanın sunulacağı sepet kalemlerinizdeki sigorta bilgisinden çözülür; bir ürüne bağlı olmayan sigortalar sepet kalemi olmadan sunulur. Uygun bir sigorta yoksa alıcıya sigorta gösterilmez.
Alıcı teklifi seçer
Alıcıya sağlayıcınızın teklifi gösterilir: prim, teminat özeti ve şartlar. Sigorta hiçbir zaman önceden seçili gelmez; alıcının açık onayı gerekir.
Prim tahsil edilir
Prim, tahsilat biçiminize göre alınır (aşağıya bakın).
Poliçe kesilir
Poliçe, prim tahsil edildikten sonra kesilir. Sonucu webhook ile ve panelde izlersiniz.
Sepet bilgisi ve ön veri
Sigortalanacak ürünü sepet kaleminde gönderirken sigorta alanlarını da eklersiniz. Alanların tamamı ve kuralları: Sepet Kalemleri › Sigorta alanları.
| Alan | Ne taşır |
|---|---|
insuranceCategory, insuranceTypes | Kalemin türü ve sunulacak sigorta tipleri. |
insuranceValueAmount | Bir birimin sigortalanacak değeri. |
insuranceContext | Kişisel olmayan bilgiler: sefer, cihaz modeli, seyahat günleri gibi. |
insuranceData | Teklif için gereken diğer bilgiler, kişisel veriler dahil: sigortalı, IMEI, rezervasyon kodu, plaka gibi. |
insuranceContext ve insuranceData ile teklif için gereken bilgiyi önceden verirsiniz; alıcıya aynı bilgiler yeniden sorulmaz. Ne kadarını gönderdiğinize göre:
| Gönderdiğiniz | Checkout Form'da | API'de |
|---|---|---|
| Hiçbir şey | Bugünkü gibi: alıcı bilgileri formda doldurur. | Teklif isteğinde bütün alanları siz gönderirsiniz. |
| Bilgilerin bir kısmı | Gelen alanlar dolu gelir; kişisel olanlar maskeli gösterilir. Alıcı yalnızca eksikleri doldurur. | Uygunluk yanıtı hangi alanların geldiğini gösterir; teklif isteğinde yalnızca eksikleri gönderirsiniz. |
| Teklif için gereken her şey | Poliçe için gereken alanlar da geldiyse form açılınca teklif kendiliğinden alınır ve ödeme adımında fiyatıyla gösterilir. Yalnızca teklif alanları geldiyse alıcı poliçe alanlarını doldurup teklif alır. | Uygunluk yanıtında quoteReady: true döner; teklifi ek alan göndermeden alabilirsiniz. |
- Sigorta hiçbir durumda kendiliğinden eklenmez. Teklif hazır gelse de alıcı sigortayı ve şartları kendisi onaylar.
- Ön veri ödemenizi değiştirmez. Göndermezseniz ödeme ve sigorta bugünkü gibi çalışır.
- Kalemin ön verisi tipin kurallarına uymazsa ödeme durmaz; o kalemin ön verisi kullanılmaz ve bilgiler alıcıdan istenir.
Formdaki davranış: Davranış Kuralları › Ön veriyle gelen bilgiler. API'de: Teklif › Ön veriyle teklif.
Kişisel veri
insuranceData kişisel veri taşır. Lunixi bu veriyi şöyle işler:
| Konu | Davranış |
|---|---|
| Nereye gider | Yalnızca sigorta için kullanılır ve teklif alınırken bağlantınızdaki sağlayıcıya iletilir. Ödeme işlemine ve ödeme sağlayıcınıza iletilmez. |
| Nasıl saklanır | Ödeme isteğiyle (POST /payments/intents) gönderdiğiniz ön veri şifreli saklanır. Sigorta API isteklerinde (context.items) gönderdiğiniz ön veri ayrıca saklanmaz; yalnızca o istekte kullanılır. |
| Ne zaman silinir | Ödeme isteğiyle gönderdiğiniz ön veri, ödeme oluşturulduktan 24 saat sonra, ödeme tamamlanmış olsun ya da olmasın, en geç bir saat içinde silinir. |
| Teklif alınınca | Teklif için kullanılan bilgiler, alıcının formda girdiği bilgiler gibi teklifin içinde şifreli tutulur; poliçe bu bilgilerle kesilir. |
| Nerede görünür | Uygunluk yanıtında kişisel değerler maskelidir (***). İstek kayıtlarında ödeme isteğinin insuranceData alanı bütünüyle gizlenir, sigorta isteklerinde kişisel değerler maskelenir. Hata yanıtları yalnızca alan yolunu taşır. |
Sağlayıcı bağlantısı ve sözleşme
- Sigorta sözleşmesi sizinle sağlayıcınız arasındadır. Sağlayıcı bağlantısı, sağlayıcıyla yaptığınız kendi anlaşmanızı Lunixi'ye tanıtır; bağlantı bilgilerinizi panelden girersiniz.
- Lunixi primi kendi adına tahsil etmez ve sağlayıcıya para aktarmaz.
- Entegrasyonunuz sağlayıcıya bağlı değildir. Sigorta tipleri, alanlar, durumlar ve hata kodları hangi sağlayıcıyla çalışırsanız çalışın aynıdır. Sağlayıcınızı değiştirdiğinizde bağlantınızı panelden değiştirirsiniz; kodunuz değişmez.
- Bir poliçenin hangi bağlantınızdan kesildiğini yanıtlarda ve panelde görürsünüz. Sağlayıcınızla mutabakatı bu bilgiyle yaparsınız; rapor: Mutabakat Raporu.
Primi kim tahsil eder
Primi kimin tahsil edeceğini sağlayıcınızla yaptığınız anlaşma belirler. Bağlantınızda açtığınız her sigorta ürünü için bunu siz belirtirsiniz; Lunixi sizin yerinize seçim yapmaz.
Primi siz tahsil edersiniz. Prim sizin satışınızın bir parçasıdır:
- Ödemeyi Lunixi ile alıyorsanız prim, ödemeye ayrı bir kalem olarak eklenir ve alıcı ürünle sigortayı tek çekimde öder. Ödeme kaydınızda prim ayrı kalem olarak görünür.
- Ödemeyi Lunixi dışında alıyorsanız ödemenin alındığını API'ye bildirirsiniz; Lunixi bildirimi bağlantınız üzerinden sağlayıcınıza iletir: Yalnız Sigorta Entegrasyonu.
Tahsil ettiğiniz primi sağlayıcınıza anlaşmanıza göre siz aktarırsınız. Prim iadesi gerekirse iade de sizin ödemenizden yapılır.
Primi sağlayıcı tahsil eder. Prim sizin ödemenize eklenmez; sağlayıcınız primi ayrı bir çekimle alır:
- Sizin bir ödemeniz varsa önce o alınır. Ardından prim, sağlayıcının ürününe göre alıcının kartından ya da sağlayıcının ödeme sayfasında çekilir. Kart bilgisini yalnızca PCI-DSS sertifikalı merchant'lar gönderebilir.
- Prim çekilemezse sizin ödemeniz geçerli kalır.
- Bu biçim yalnızca API ile kullanılır; Lunixi ödemesiyle de Lunixi ödemesi olmadan da çalışır: Sağlayıcı Tahsilatı.
Bir sigorta ürününü yalnızca, sağlayıcının o ürün için desteklediği tahsilat biçimlerinden biri anlaşmanızla eşleşiyorsa sunabilirsiniz.