Sigorta Satış (Insurance Sale)

Bu sayfada, sigorta satış ve ön provizyon işlemlerinin API parametreleri, işlem akışı ve entegrasyon detayları açıklanmaktadır.

Sigorta Satışı

Sigorta işlemleri, kartın ilk 8 ve son 4 hanesi kullanılarak gerçekleştirilebilen özel bir satış türüdür. Bu yöntemle yapılan işlemler, Moto tipi olarak değerlendirilir ve aşağıdaki parametrelerle gönderilmelidir:

Parametre	Değer / Açıklama
kart numarası	İlk 8 + Son 4 hane
ecommerceTxnType	1 → Moto işlem tipi
txnInitiationType	4 → Sigorta ödemesi
identificationNumber	Kart sahibine ait kimlik numarası/VKN

Bu işlemde 3D Secure doğrulaması yapılmaz. Kartın tamamı kullanılmadığı için işlem güvenliği issuer banka tarafından sağlanır.

Not: Bu işlem yalnızca sigorta satış yetkisi olan kullanıcılar tarafından yapılabilir. Yetkiniz yoksa işlem gönderilememektedir.

Ayrıca, sigorta işlemleri tam kart numarası ile de gerçekleştirilebilir. Bu durumda işlem, non-secure satış olarak değerlendirilir. Eğer işlem tam kart numarası ile yapılacaksa, bu durumda Satış ve Ön Provizyon istek parametreleri eksiksiz şekilde gönderilmelidir. TCKN, VKN gibi ek kişisel veriler bu işlem tipi için gerekli değildir.

Parametre	Değer / Açıklama
ecommerceTxnType	0 (E-Ticaret) veya 1 (Moto)
txnInitiationType	0 → Varsayılan
Kart Formatı	Tam kart numarası
İşlem Tipi	Non-secure satış

Sigorta İşlemlerinde;

• Ön provizyon işlemi desteklenmektedir. Bu sayede işlem tutarı geçici olarak bloke edilebilir ve daha sonra Ön Provizyon Kapatma (Post-Sale) isteği gönderilerek kesinleştirme yapılabilir.

• Puanla ödeme desteklenmemektedir. Sadakat puanları veya kampanya puanları ile ödeme bu işlem tipi için geçerli değildir.

Geliştirici Notları

• Satış isteği API çağrısında mutlaka:

  • Header parametreleri (x_client_token, x_signature, nonce, timestamp) doğru şekilde gönderilmelidir.

  • Request gövdesi (HTTP body) hatasız ve imzaya uygun şekilde hazırlanmalıdır.

• Response Kontrolleri:

• state → İşlemin başarılı olup olmadığını gösterir

• result → İşlem sonucunun detaylarını gösterir (tutar, işlem ID, ödeme durumu, vb.)

• resultCode → VPOS uygulaması işlem durum kodu, reddedilen işlemlerde hata kodu döner. resultMessage alanında mesaj detayları bulunmaktadır.

• procReturnCode → ISO-8583 formatında finansal işlem sonucu kodu döner. İşlem sonucu, issuer/acquirer banka tarafından belirlenir.