Kurulum

Sağlayıcınızı bağlayın

Panelde POS Merkezi > Sigorta sayfasını açın. Anlaştığınız sağlayıcının kartında Aktif Et ile bağlantıyı ekleyin:

• Ortam olarak Test ya da Canlı'yı seçin ve sağlayıcınızın size verdiği kimlik bilgisini girin. Kimlik bilgisi güvenli kasaya yazılır ve bir daha gösterilmez.
• Bağlantının detayında, Bağlantıdaki ürünler bölümünde sunacağınız sigorta ürününü açın.
• Ürünü açarken Primi kim tahsil ediyor sorusuna Siz tahsil edersiniz yanıtını verin. Checkout Form'da prim sizin ödemenize eklenir; bu yüzden formda yalnızca primi sizin tahsil ettiğiniz ürünler sunulur.

Primi kimin tahsil edeceğini sağlayıcınızla yaptığınız anlaşma belirler; bkz. Sigorta › Primi kim tahsil eder. Test bağlantısı ve ortamlar: Test Ortamı.

Sigortayı açın ve sunacağınız tipi seçin

Panelin sol menüsündeki Sigorta ürününde:

• Genel ekranında Sigorta açık ayarını açın ve Ödeme formu kullanım modunu seçin. Sigorta kapalıysa ya da bu mod seçili değilse formda sigorta görünmez: Sigorta Menüsü › Genel.
• Sigorta Tipleri ekranında sunacağınız tipi açıp kaydedin. Tipler varsayılan olarak kapalıdır: Sigorta Menüsü › Sigorta Tipleri.

Form ayarlarında sigortanın yerini seçin

Panelde Form Ayarları > Sigorta bölümünde sigortanın formda nerede gösterileceğini seçin:

• İki ayar da varsayılan olarak kapalıdır. İkisi de kapalıysa formda sigorta hiç görünmez ve form sigorta için hiçbir istek yapmaz.
• Aktif bir sigorta bağlantınız yoksa bölüm kilitli görünür ve salt-okunurdur; kayıtlı ayarınız değişmez. Önce 1. adımı tamamlayın.
• Formda sigortayı yalnızca panelden açıp kapatırsınız. Ödeme isteğinin settings alanıyla sigorta açılmaz ve kapatılmaz; settings içinde sigorta ayarı gönderirseniz istek 400 VALIDATION_ERROR ile reddedilir.

Ödeme oluştururken sepet kalemlerine sigorta alanlarını ekleyin

Ödemeyi her zamanki gibi POST /payments/intents ile oluşturun (Checkout Formu). Sigorta sunmak istediğiniz kalemlere sigorta alanlarını ekleyin:

• Sigorta yalnızca basketItems gönderdiğiniz ödemede sunulur. Sepeti olmayan ödemede formda sigorta görünmez.
• Sigorta alanı olmayan kaleme sigorta sunulmaz. En az insuranceCategory gereklidir.
• Sigorta birim başınadır: sigorta alanı taşıyan kalemde her birimi ayrı kalem olarak gönderin ve kalem id'lerini tekil tutun.
• insuranceContext ile sefer bilgisi gibi kişisel olmayan bilgileri gönderebilirsiniz. Bu bilgiler formda dolu gelir.
• Alıcının bilgisi sizde varsa (sigortalı, rezervasyon kodu, IMEI, plaka gibi) insuranceData ile gönderebilirsiniz. Kısmi olabilir: gelen alanlar formda maskeli gösterilir, alıcı yalnızca eksikleri doldurur. Teklif ve poliçe için gereken her şeyi gönderirseniz form açılınca teklif kendiliğinden alınır. Rezervasyon kodu ve kişi bilgisi insuranceContext'te gönderilmez.

Alanların tamamı ve kuralları: Sepet Kalemleri › Sigorta alanları. Ön verinin biçimi ve tip başına örnekler: Sepet Kalemleri › Sigorta ön verisi.

İki biletli bir ödeme isteği. Her bilet sefer bilgisini, yolcusunu (iletişim bilgisiyle), bilet tutarını, rezervasyon kodunu ve bilet numarasını taşıdığı için teklif form açılınca kendiliğinden alınır. insuranceData'yı göndermezseniz bu bilgileri alıcı formda doldurur. Değerler örnektir; açılı parantez içindeki değerlerin yerine alıcınızın bilgilerini yazın:

{
  "amount": 100000,
  "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"],
      "insuranceContext": {
        "transportMode": "TRAIN",
        "departureAt": "2025-12-23T12:50:00+03:00",
        "originCity": "İzmir",
        "destinationCity": "Ankara",
        "carrier": "Örnek Taşıyıcı"
      },
      "insuranceData": {
        "insured": [
          { "identityType": "PASSPORT", "identityNumber": "<pasaport numarası>", "birthDate": "<YYYY-MM-DD>",
            "email": "<e-posta>", "phone": "<+90 ile telefon>" }
        ],
        "tickets": { "priceAmount": 50000, "pnr": "<rezervasyon kodu>", "ticketNumber": "<bilet numarası>" }
      }
    },
    {
      "id": "ticket-2",
      "name": "İzmir-Ankara tren bileti",
      "price": 50000,
      "category1": "bilet",
      "itemType": "VIRTUAL",
      "insuranceCategory": "TICKET",
      "insuranceTypes": ["TICKET_CANCELLATION"],
      "insuranceContext": {
        "transportMode": "TRAIN",
        "departureAt": "2025-12-23T12:50:00+03:00",
        "originCity": "İzmir",
        "destinationCity": "Ankara",
        "carrier": "Örnek Taşıyıcı"
      },
      "insuranceData": {
        "insured": [
          { "identityType": "PASSPORT", "identityNumber": "<pasaport numarası>", "birthDate": "<YYYY-MM-DD>",
            "email": "<e-posta>", "phone": "<+90 ile telefon>" }
        ],
        "tickets": { "priceAmount": 50000, "pnr": "<rezervasyon kodu>", "ticketNumber": "<bilet numarası>" }
      }
    }
  ]
}

amount, alıcı sigorta seçmeden önceki tutardır. Primi siz eklemezsiniz; alıcı sigortayı seçerse prim ödeme gönderilirken eklenir (Ödeme ve Prim).

Formu açın ve doğrulayın

Formu her zamanki gibi açın. Uygun bir teklif varsa form, açtığınız yerde sigortayı gösterir. Teklif ve poliçe için gereken her şeyi gönderdiyseniz teklif ödeme adımında fiyatıyla görünür; sigorta yine alıcının onayıyla eklenir: Davranış Kuralları › Ön veriyle gelen bilgiler. Kart alanı (createCardField) varyantında sigorta gösterilmez; sigorta için tam formu kullanın.

Test anahtarınızla ve test bağlantınızla deneyin: Test Ortamı. Sigorta görünmüyorsa: Sigorta sunulmuyorsa.