Panel Giriş Başvurun
Tahsilat Metodu

Sigorta Ödemeleri — TCKN ile

Sigorta şirketlerine özel ödeme akışı: standart ödemeden farklı olarak kart sahibinin TCKN'si, kartın BIN'i ve son dört hanesi de işleme dahil edilir; poliçe ödemeleri güvenle eşleştirilir.

Gereksinimler

Aşağıdaki koşullar sağlanmadan işlem reddedilir:

  • MCC 6300 — üye işyerinizde sigorta MCC'si tanımlı olmalı (sağlık, hayat ve genel sigorta); değilse destek ekibiyle iletişime geçin
  • Non Secure işlem yetkisi — kartın 3D doğrulamasından geçirilmediği akış için bu yetki açık olmalı

Endpoint

TESTPOST https://paynkolaytest.nkolayislem.com.tr/Vpos/v1/InsurancePayment

PRODPOST https://paynkolay.nkolayislem.com.tr/Vpos/v1/InsurancePayment

Sigorta ödemeleri, standart ödeme ucundan (/Vpos/v1/Payment) farklı özel bir endpoint kullanır.

Test Ortamı Bilgileri

Sigorta ödemeleri, MCC 6300 ve Non Secure yetkisi tanımlı ayrı test üye işyerleri üzerinden çalışır — genel test bilgilerinden farklıdır ve değerler birbirinin yerine kullanılamaz.

Test Üye İşyeri — 400001647
Üye İşyeri No: 400001647

SX: 163164707|G2l+Lv3mnqLYI9LQbByiDULWSu2yhEtF7Tg9yrqH6FZrmQh21oG6lhTk3EVLG8IvjHYdveMBE1lAktQwQpvPzeI9hTDRY3R+C+ELwHiIA/lCYY1qqJ0GIw2Imf6+Nocbx05fhg==

SX Listeleme: 163164707|G2l+Lv3mnqLYI9LQbByiDULWSu2yhEtF7Tg9yrqH6FZrmQh21oG6lhTk3EVLG8IvjHYdveMBE1lAktQwQpvPzeI9hTDRY3R+C+ELwHiIA/lCYY1qqJ0GIw2Imf6+Nocbx05fhg==|r/PZW9UJQbLcCZ4q6F7rcA==

SX İptal: 163164707|G2l+Lv3mnqLYI9LQbByiDULWSu2yhEtF7Tg9yrqH6FZrmQh21oG6lhTk3EVLG8IvjHYdveMBE1lAktQwQpvPzeI9hTDRY3R+C+ELwHiIA/lCYY1qqJ0GIw2Imf6+Nocbx05fhg==|sJtsGgFHnkgHZJWI3d471A/+TJA7C81X

Merchant Secret Key: _TaKyD6FWjY14NqkHlq3Y
Test Üye İşyeri — 400001820
Üye İşyeri No: 400001820

SX: 164979316|NP6r2XMACY/P12xD4D8bzKv/fiCLL58Yi6/121SGpBYhPlw5m/peyjnl0DCX7oVauoxtymHkhlrUPSd0hOKFh9/041ccs/l7MdJ4SRREmHwkpjoAvHfg4SvwXeP6mdzqNjxjuw==

SX Listeleme: 164979316|NP6r2XMACY/P12xD4D8bzKv/fiCLL58Yi6/121SGpBYhPlw5m/peyjnl0DCX7oVauoxtymHkhlrUPSd0hOKFh9/041ccs/l7MdJ4SRREmHwkpjoAvHfg4SvwXeP6mdzqNjxjuw==|lwEfIFbweEFbjSYiyGlZPA==

SX İptal: 164979316|NP6r2XMACY/P12xD4D8bzKv/fiCLL58Yi6/121SGpBYhPlw5m/peyjnl0DCX7oVauoxtymHkhlrUPSd0hOKFh9/041ccs/l7MdJ4SRREmHwkpjoAvHfg4SvwXeP6mdzqNjxjuw==|zzBOIDSogGXafjX51FqW8w/+TJA7C81X

Merchant Secret Key: _XW3IhD1rFsmlQfQTYewe

Aşağıdaki kimlik üçlüsü her iki test üye işyeri için de geçerlidir ve birlikte gönderilmelidir; kart numarası/CVV için Test Kartları sayfasına bakın:

AlanTest Değeri
CardHolderIdentity (TCKN)74924239426
CardBinNumber (ilk 8 hane)49384101
CardLastFour (son 4 hane)5591

Hash Hesaplama

Sigorta ödemelerinde hashDataV2, standart formülden farklı olarak BIN, son dört hane ve TCKN'yi de içerir:

Formül
sx | clientRefCode | amount | successUrl | failUrl | rnd | CardBinNumber | CardLastFour | CardHolderIdentity | MerchantSecretKey
PHP
$hashstr = $sx . '|' . $clientRefCode . '|' . $amount . '|' . $successUrl . '|' . $failUrl . '|' . $rnd
         . '|' . $CardBinNumber . '|' . $CardLastFour . '|' . $CardHolderIdentity . '|' . $merchantSecretKey;

$hashDataV2 = base64_encode(hash('sha512', $hashstr, true));

Parametreler

ParametreZorunluAçıklama
sx✅SX değeriniz
clientRefCode✅İşleme ait referans numaranız
successUrl / failUrl✅Başarılı / başarısız işlem sonrası yönlendirme adresleri
amount✅Ödeme tutarı (nokta ile ondalık, ör. 30.00)
installmentNo✅Taksit sayısı; tek çekim için 1
cardHolderName✅Kart üzerindeki isim
encodedValue✅Şifrelenmiş kart bilgisi (Non Secure işlemlerde kullanılır)
transactionType✅Her zaman SALES
rnd✅Zaman damgası (ör. 2026-03-05T15:27:05.597196)
hashDataV2✅Yukarıdaki formülle üretilen imza
currencyNumber✅Para birimi kodu; TL için 949
CardBinNumber✅Kartın ilk 8 hanesi (BIN)
CardLastFour✅Kartın son 4 hanesi
CardHolderIdentity✅Kart sahibinin TCKN'si
merchantCustomerNo❌Üye işyerine ait müşteri numarası
cardHolderIP❌Müşterinin IP adresi

Postman koleksiyonundaki Sigorta Ödemeleri klasörü hash'i otomatik hesaplar; koleksiyon 400001647 numaralı üye işyerinin bilgileriyle gelir, diğerini kullanmak için sx-insurance ve merchantSecretKey-insurance değişkenlerini güncelleyin.

Son güncelleme: 5 Eylül 2026

v2 · Versiyonlar