Prim ve Ödeme

Bu sayfa primi sizin tahsil ettiğiniz (premiumCollectedBy: MERCHANT) siparişler içindir. Prim ya Lunixi ödemenizin bir kalemidir ya da Lunixi dışında aldığınız bir ödemedir. Poliçe, prim tahsil edildikten sonra kesilir.

Primi sağlayıcınız tahsil ediyorsa (premiumCollectedBy: PROVIDER) bu sayfa yerine Sağlayıcı Tahsilatı sayfasını kullanın.

Lunixi ödemesiyle

Alıcı ürünü ve sigortayı tek ödemede öder. Prim, ödemenizin sepetinde ayrı bir kalemdir; kalemin kimliği sigorta siparişinin kimliğidir.

Prim kalemi

• Prim kalemi sigorta alanı taşımaz. inso_ kimlikli bir kalemde sigorta alanı gönderilirse ödeme isteği 400 VALIDATION_ERROR ile reddedilir.
• Sepette sipariş başına tek bir prim kalemi bulunur.
• Sepetteki kalemlerin price toplamı, ödeme isteğinin amount alanına eşit olmalıdır. Bu yüzden ödemenin tutarı, kalemlerinizin tutarı ile primin toplamıdır. Kural: Sepet Kalemleri.

İki biletli bir sepete 39,80 TRY primli sigorta eklenmiş ödeme isteği. Tutarlar örnektir:

{
  "amount": 103980,
  "currency": "TRY",
  "orderId": "order-1001",
  "callbackUrl": "https://example.com/payments/callback",
  "basketItems": [
    {
      "id": "ticket-1",
      "name": "İzmir-Ankara tren bileti",
      "price": 50000,
      "category1": "bilet",
      "itemType": "VIRTUAL",
      "insuranceCategory": "TICKET",
      "insuranceTypes": ["TICKET_CANCELLATION"]
    },
    {
      "id": "ticket-2",
      "name": "İzmir-Ankara tren bileti",
      "price": 50000,
      "category1": "bilet",
      "itemType": "VIRTUAL",
      "insuranceCategory": "TICKET",
      "insuranceTypes": ["TICKET_CANCELLATION"]
    },
    {
      "id": "inso_<32 onaltılık hane>",
      "name": "Bilet iptal sigortası",
      "price": 3980,
      "category1": "sigorta",
      "itemType": "VIRTUAL"
    }
  ]
}

Siparişin ödemeye bağlanması

• bind-payment ile bağladığınızda kurallar hemen doğrulanır ve hata yanıtta döner. Önerilen yol budur.
• bind-payment çağırmazsanız sipariş, ödeme tahsil edildiğinde sepetteki prim kalemiyle eşleştirilip ödemeye bağlanır. Eşleşme kuralları tutmazsa sipariş bağlanmaz ve poliçe istenmez; tahsil edilen tutar ödemenizde kalır ve sipariş açık kalır. Bu durumu hata yanıtıyla göremezsiniz; bu yüzden bind-payment kullanın.
• Seçeneğin süresi dolmadan bağlayın: bind-payment, süresi dolan seçenekte 409 insurance.quote.expired döner.
• Ödemenin sigorta alanlı kalemleri teklifteki kalemlerden farklıysa (id, tutar ya da sigortalanacak değer) bağlama 409 insurance.quote.stale döner. Yeni teklif alın; siparişi yeni seçenekle oluşturun.

Prim ne zaman tahsil edilmiş sayılır

• Prim, ödemenin tahsil edilen tutarı prime ulaştığında tahsil edilmiş sayılır: tahsilat COLLECTED olur ve poliçe PENDING olarak istenir.
• Ön provizyonlu ödemede provizyon yetmez; tahsilat (capture) gerekir. Kısmi tahsilatlarda önce prim kuralı geçerlidir: tahsil edilen toplam tutar prime ulaştığında prim tahsil edilmiş sayılır. Ulaşana kadar tahsilat PENDING kalır.
• Ödeme tahsil edilmeden iptal edilir, süresi dolar ya da kesin olarak başarısız olursa tahsilat FAILED olur, errorCode insurance.premium.not_captured olur ve poliçe istenmez.
• Poliçe, ürünün son tarihine kadar kesilmeye çalışılır. Kesin olarak kesilemezse poliçe FAILED_FINAL, iade REQUIRED olur: İptal ve Prim İadesi › İade gerekiyor.

Ödeme kaydınızda prim

• Prim, satışınızın bir kalemi olarak ödemenizle birlikte size gelir. Primi sağlayıcınıza anlaşmanıza göre siz aktarırsınız; Lunixi primi kendi adına tutmaz.
• Ödemenizden kendiniz yaptığınız tutar iadesi sigortaya bağlı değildir ve poliçeyi iptal etmez. Poliçeyi iptal etmek ve primi iade etmek için sigorta uçlarını kullanın: İptal ve Prim İadesi.

Lunixi dışında tahsil edilen prim

Primi kendi ödeme kanalınızdan tahsil ettiyseniz ödemeyi Lunixi'ye bildirirsiniz. Lunixi bildirimi bağlantınız üzerinden sağlayıcınıza iletir; ayrıca bir belge ya da kanıt istemez.

• Bildirdiğiniz tutar ve para birimi siparişin primiyle aynı olmalıdır.
• Bu akışta iade, ters ibraz ve itirazlar sizinle sağlayıcınız arasındadır. Primi iade ettiğinizde iadeyi API'ye bildirirsiniz: İptal ve Prim İadesi › Lunixi dışında iade.

İlgili

• Sipariş ve Ödeme Bağlama: bind-payment, confirm-payment, issue-policy
• Sepet Kalemleri: kalem alanları ve sepet toplamı kuralı
• Kavramlar ve Durumlar: tahsilat ve poliçe eksenleri
• Sağlayıcı Tahsilatı: primi sağlayıcının tahsil ettiği siparişler
• Yalnız Sigorta Entegrasyonu: Lunixi ödemesi olmadan uçtan uca akış