Ödeme Sorgulama
Yanıtını alamadığınız ya da doğrulamak istediğiniz işlemin güncel durumunu PaymentList servisiyle sorgulayın; sipariş onayını her zaman sorgu sonucuna dayandırabilirsiniz.
Ne Zaman Gerekir?
- Zaman aşımı ya da bağlantı kopması nedeniyle ödeme isteğinin yanıtı size ulaşmadıysa — işlemin gerçekleşip gerçekleşmediğini buradan doğrularsınız.
- Yarıda kalmış işlemleri (
STATUS=NEW) tespit edip mükerrer çekimi önlemek için. - 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 |
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:
| STATUS | Anlamı |
|---|---|
| SUCCESS | İşlem başarılı, para çekildi |
| ERROR | İşlem başarısız |
| NEW | Başlatılmış ama tamamlanmamış işlem — ödeme alınmamış |
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.
Son güncelleme: 10 Eylül 2026