Ödeme Sorgulama

3D Secure ödemenin güncel durumunu PaymentList servisiyle sorgulayın — doğrulama sonucu adresinize ulaşmadığında ya da 2 aşamalı işlemin tamamlanıp tamamlanmadığını teyit etmek istediğinizde.

Ne Zaman Gerekir?

Müşteri 3D doğrulama sayfasını kapattıysa ya da bağlantı koptuysa imzalı sonuç successUrl / failUrl adresinize hiç ulaşmaz — işlemin gerçekleşip gerçekleşmediğini buradan doğrularsınız.
2 aşamalı modda (AUTOCOMPLETE=false) doğrulanmış ama henüz tamamlanmamış işlemleri bulmak için — bu işlemler STATUS=NEW döner ve CompletePayment ile tamamlanır.
Muhasebe/uzlaştırma süreçlerinde işlemin banka tarafındaki nihai durumunu teyit etmek için.

Uç Nokta ve Parametreler

Test POST https://paynkolaytest.nkolayislem.com.tr/Vpos/Payment/PaymentList

Canlı POST https://paynkolay.nkolayislem.com.tr/Vpos/Payment/PaymentList

Bu servis satış sx'inizle değil, sx List değerinizle çağrılır — üç sx'in ayrımı için Test Ortamı sayfasına bakın.

Parametre	Zorunlu	Açıklama
sx	✅	sx List değeriniz (satış sx'inden farklıdır)
startDate	✅	Başlangıç tarihi (DD.MM.YYYY)
endDate	✅	Bitiş tarihi (DD.MM.YYYY)
clientRefCode	—	Sorgulanacak işlemin referans kodu; boş bırakılırsa aralıktaki tüm işlemler döner (en fazla 1 aylık aralık)
hashDatav2	✅	Aşağıdaki formülle üretilen imza

Hash Formülü

hashDatav2 = Base64(SHA512(sx | startDate | endDate | clientRefCode | merchantSecretKey))

Yanıt ve Durumlar

Yanıttaki LIST dizisinde her işlem için STATUS, tutarlar, kart ve banka bilgileri döner; IS_3D alanı 3D Secure işlemleri ayırt eder:

STATUS	Anlamı
SUCCESS	İşlem başarılı, para çekildi
ERROR	İşlem başarısız
NEW	Başlatılmış ama tamamlanmamış işlem — 3D doğrulama yarıda kalmış ya da 2 aşamalı işlem için CompletePayment çağrılmamış

Servis yanıtının başarılı dönmesi işlemin başarılı olduğu anlamına gelmez — her kaydın STATUS değerini kontrol edin. Örnek yanıt ve alan listesi için İşlem Doğrulama Servisi, dönemsel raporlar için Raporlama Servisi sayfalarına bakın.

Bu sayfa yardımcı oldu mu?

Son güncelleme: 11 Eylül 2026