Sigorta
API Yolu
Sepet Kalemi Olmadan Satış

Sepet Kalemi Olmadan Satış

Bazı sigorta tipleri bir sepet kalemini korumaz; alıcı sigortayı tek başına satın alır. Örneğin yıllık ferdi kaza (PERSONAL_ACCIDENT) bir kişiyi korur, sepetteki bir ürünü değil. Bu tiplerin teklifi sepet kalemi olmadan alınır ve teminatın bilgileri tip nesnesindedir. Bazı tipler iki yolla da satılır: sepet kalemiyle ve sepet kalemi olmadan (örneğin evcil hayvan sağlık sigortası, PET_HEALTH).

  • Sepet kalemi olmadan satış yalnızca API yolundadır. Yalnızca sepet kalemi olmadan satılan tipler Checkout Form'da ve ödeme linkinde sunulmaz; iki yolla satılan tipler orada yalnızca sepet kalemiyle sunulur.
  • Hangi tiplerin sepet kalemi olmadan satıldığı tip kataloğundadır: kalem türü olmayan tipler ve "sepet kalemi olmadan da satılır" yazan tipler (Sigorta Tipleri ve Şemalar).
  • Teklif vermeyen talep tipleri bu sayfanın kapsamında değildir: Talep.
  • Yalnızca sepet kalemiyle satılan bir tip sepet kalemi olmadan istenemez; yalnızca sepet kalemi olmadan satılan bir tip de sepet kalemiyle sunulmaz.

Kimlik doğrulama ve imzalama: Akışlar › Kimlik doğrulama.

Akış

Sepet kalemi olmadan satışSüreç: sepet kalemi olmadan satılan tipleri listeler, sepet kaynağı olmadan teklif alır, siparişi oluşturur, primi seçeneğin premiumCollectedBy değerine göre tahsil eder ve siparişi izlersiniz.UygunlukGET …/productsTeklifsepet kaynağı yokSiparişPOST …/ordersPrimi tahsil edinpremiumCollectedBySiparişi izleyinGET …/orders/{orderId}LEJANTADIMSEPET KALEMİ OLMADAN
…, /api/v1/insurance yerine geçer. GET …/products çağrısını paymentIntentId olmadan yapın; yanıt yalnız sepet kalemi olmadan satılan tipleri listeler.

Uygunluğu kontrol edin

GET /api/v1/insurance/products ucunu paymentIntentId olmadan çağırın. Yanıt, hesabınızda açık olan ve sepet kalemi olmadan satılan tipleri döner; basketItemIds boş dizidir. Ayrıntı: Uygunluk › Sepet kalemi olmadan.

Teklif alın

Teklif isteğinde context.items ve paymentIntentId göndermeyin. Sigortalının ve poliçenin bilgilerini, sepete bağlı tiplerde olduğu gibi teklif isteğinde gönderin. Kurallar aşağıda.

Sipariş oluşturun

Alıcının onayladığı seçenekle sipariş oluşturun: Sipariş ve Ödeme Bağlama. Sipariş kuralları sepete bağlı satışla aynıdır.

Primi tahsil edin

Tahsilat seçeneğin premiumCollectedBy değerine göre yapılır: Primin tahsilatı.

Poliçeyi izleyin

Siparişin durumunu sipariş ucundan izleyin; poliçe kesildiğinde belgesini alın: Poliçe Belgesi.

Teklif

İstek Teklif ucuyla aynıdır; yalnızca sepet kaynağı gönderilmez.

  • context.items ve paymentIntentId gönderilmez. İkisinden biri gönderilirse teklif sepete bağlı sayılır ve yalnızca sepet kalemi olmadan satılan tipler sunulmaz.
  • Tip nesnesinde basketItemId gönderilmez; gönderilirse istek 422 insurance.validation.invalid alır.
  • Yalnızca sepet kalemiyle satılan bir tip sepet kalemi olmadan istenirse 412 insurance.type.not_available döner.
  • Hesabınızda tip için tanımladığınız tutar sınırları kalem tutarına göre çalışır; sepet kalemi olmadan satışta uygulanmaz.
  • Yanıtın biçimi aynıdır. Seçeneklerde basketItemIds boş dizi, paymentIntentId null döner.

PERSONAL_ACCIDENT için poliçe alanlarıyla birlikte bir teklif isteği. Değerler örnektir; açılı parantez içindeki değerlerin yerine alıcınızın bilgilerini, meslek kodunun yerine referans ucundan aldığınız kodu yazın:

{
  "insuranceType": "PERSONAL_ACCIDENT",
  "currency": "TRY",
  "merchantOrderId": "order-2001",
  "insured": [
    {
      "identityType": "TCKN",
      "identityNumber": "<kimlik numarası>",
      "birthDate": "<YYYY-MM-DD>",
      "email": "<e-posta>",
      "phone": "<E.164 telefon>"
    }
  ],
  "accident": {
    "coverageStartDate": "<YYYY-MM-DD>",
    "occupationCode": "<meslek kodu>",
    "beneficiaryName": "<lehtarın adı>"
  }
}
source lunixi-sign.sh
BODY='<teklif isteği, boşluksuz JSON>'
lunixi_sign POST "/api/v1/insurance/quotes" "$BODY"
 
curl -X POST "https://api-gateway.lunixi.com/api/v1/insurance/quotes" \
  -H "Content-Type: application/json" \
  -H "X-Key-Id: $LUNIXI_KEY_ID" \
  -H "X-Date: $DATE" \
  -H "X-Nonce: $NONCE" \
  -H "Digest: $DIGEST" \
  -H "X-Signature: $SIGNATURE" \
  --data-raw "$BODY"

Tipin alanları: Sigorta Tipleri ve Şemalar › PERSONAL_ACCIDENT.

Primin tahsilatı

Primi kimin tahsil ettiğini seçeneğin premiumCollectedBy değeri gösterir. Tahsilat yolları sepete bağlı satışla aynıdır:

premiumCollectedByTahsilatAyrıntı
PROVIDERPrimi sağlayıcınız tahsil eder.Sağlayıcı Tahsilatı
MERCHANT, Lunixi ödemesiylePrim, Lunixi ödemenizin sepetinde ayrı bir kalemdir.Lunixi ödemesiyle
MERCHANT, Lunixi dışındaPrimi kendi kanalınızdan tahsil eder, ödemeyi bildirir ve poliçeyi istersiniz.Prim ve Ödeme › Lunixi dışında

Lunixi ödemesiyle

Ödemeyi POST /api/v1/payments/intents ile oluşturun (Checkout Formu) ve sepete prim kalemini ekleyin. Ardından siparişi bind-payment ile ödemeye bağlayın: Ödemeye bağlama.

  • Sepette sigorta alanı taşıyan bir kalem gerekmez. Prim kalemi sepette tek başına ya da sigorta alanı olmayan kalemlerinizle birlikte bulunabilir.
  • Teklif bir sepete bağlı olmadığı için ödemenin sepeti teklifle karşılaştırılmaz; sepetteki diğer kalemler bağlamayı etkilemez.
  • Prim kalemi kuralları aynen geçerlidir: kalemin id'si siparişin orderId'si, price'ı siparişin premiumAmount'udur ve kalem sigorta alanı taşımaz.
  • Ödeme linkinde sepet kalemi olmadan satılan sigortanın primi alınmaz.

Yalnızca prim kalemi olan bir ödeme isteği. Tutar örnektir:

{
  "amount": 45000,
  "currency": "TRY",
  "orderId": "order-2001",
  "callbackUrl": "https://example.com/payments/callback",
  "basketItems": [
    {
      "id": "inso_<32 onaltılık hane>",
      "name": "Sigorta primi",
      "price": 45000,
      "category1": "sigorta",
      "itemType": "VIRTUAL"
    }
  ]
}

Hatalar

HTTPcodeNe yapmalı
412insurance.type.not_availableTip sepet kalemi olmadan satılmıyor ya da hesabınızda açık değil. Uygunluk listesini kontrol edin.
422insurance.validation.invalidTip alanları kurala uymuyor ya da tip nesnesinde basketItemId gönderildi. details.errors[] alan yolunu ve sebebi verir.
422insurance.reference.unknownBir referans kodu tanınmıyor ya da bağlantınızın sağlayıcısında karşılığı yok.
409insurance.order.premium_item_mismatchLunixi ödemesinin sepetindeki prim kalemi siparişle uyuşmuyor. Prim kalemi kurallarına bakın.

Diğer kodlar: Teklif › Hatalar, Hata Kodları.

İlgili