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:

Alan	Test 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

Parametre	Zorunlu	Açı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.

Bu sayfa yardımcı oldu mu?

Son güncelleme: 5 Eylül 2026