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ış
…, /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.itemsvepaymentIntentIdgönderilmez. İkisinden biri gönderilirse teklif sepete bağlı sayılır ve yalnızca sepet kalemi olmadan satılan tipler sunulmaz.- Tip nesnesinde
basketItemIdgönderilmez; gönderilirse istek422 insurance.validation.invalidalır. - Yalnızca sepet kalemiyle satılan bir tip sepet kalemi olmadan istenirse
412 insurance.type.not_availabledö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
basketItemIdsboş dizi,paymentIntentIdnulldö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:
premiumCollectedBy | Tahsilat | Ayrıntı |
|---|---|---|
PROVIDER | Primi sağlayıcınız tahsil eder. | Sağlayıcı Tahsilatı |
MERCHANT, Lunixi ödemesiyle | Prim, Lunixi ödemenizin sepetinde ayrı bir kalemdir. | Lunixi ödemesiyle |
MERCHANT, Lunixi dışında | Primi 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şinorderId'si,price'ı siparişinpremiumAmount'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
| HTTP | code | Ne yapmalı |
|---|---|---|
412 | insurance.type.not_available | Tip sepet kalemi olmadan satılmıyor ya da hesabınızda açık değil. Uygunluk listesini kontrol edin. |
422 | insurance.validation.invalid | Tip alanları kurala uymuyor ya da tip nesnesinde basketItemId gönderildi. details.errors[] alan yolunu ve sebebi verir. |
422 | insurance.reference.unknown | Bir referans kodu tanınmıyor ya da bağlantınızın sağlayıcısında karşılığı yok. |
409 | insurance.order.premium_item_mismatch | Lunixi ödemesinin sepetindeki prim kalemi siparişle uyuşmuyor. Prim kalemi kurallarına bakın. |
Diğer kodlar: Teklif › Hatalar, Hata Kodları.
İlgili
- Uygunluk: sepet kalemi olmadan satılan tipler
- Teklif: seçenekler ve elenen seçenekler
- Sigorta Tipleri ve Şemalar: tip alanları
- Prim ve Ödeme: prim kalemi ve Lunixi dışında tahsilat