Panel Giriş API Anahtarlarını Al

Ek Servisler

İşlem Doğrulama Servisi

Bir işlemin doğruluğunu ve paranın gerçekten çekilip çekilmediğini sorgulayın — banka yanıtının ham hali dahil, işlemin tüm detayı döner.

clientRefCode boş gönderilirse tarih aralığındaki tüm işlemler döner; en fazla 1 aylık veri çekilebilir. Referans kodunuzu her işlemde benzersiz üretin — aynı kodu paylaşan işlemler birlikte döner.

Endpoint ve Parametreler

TESTPOST https://paynkolaytest.nkolayislem.com.tr/Vpos/Payment/PaymentList

PRODPOST https://paynkolay.nkolayislem.com.tr/Vpos/Payment/PaymentList

ParametreZorunluAçıklama
sx✅sx Listeleme değeriniz (satış sx'inden farklıdır)
startDate✅Başlangıç tarihi (DD.MM.YYYY)
endDate✅Bitiş tarihi (DD.MM.YYYY)
clientRefCode❌Kendi referans kodunuz
hashDatav2✅Aşağıdaki formülle üretilen imza
Hash Formülü
hashDatav2 = Base64(SHA512(sx | startDate | endDate | clientRefCode | merchantSecretKey))

Yanıt

Örnek Yanıt (kısaltılmış)
{
  "RESPONSE_CODE": "2",
  "RESPONSE_DATA": "Servis dönüşü başarılı, ilgili işlemin STATUS'ünü kontrol ediniz.",
  "LIST": [
    {
      "REFERENCE_CODE": "IKSIRPF540446",
      "AUTH_CODE": "304919",
      "STATUS": "SUCCESS",
      "TRANSACTION_TYPE": "SALES",
      "IS_3D": true,
      "TRANSACTION_AMOUNT": "870.00",
      "AUTHORIZATION_AMOUNT": "870.00",
      "COMMISION": "14.9600",
      "CARD_NUMBER": "428220******8015",
      "CARD_BANK_NAME": "T.GARANTİ BANKASI A.Ş.",
      "INSTALLMENT_COUNT": 1,
      "CLIENT_REFERENCE_CODE": "13608",
      "TRX_DATE": "28.07.2026 10:16:13",
      "VALOR_DATE": "20260729",
      "BANK_RESULT": "Response : <GVPSResponse>...</GVPSResponse>"
    }
  ]
}

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. Ödeme sonucunu okuma kuralları için Altın Kural'a bakın.

Durum Değerleri

STATUSAnlamı
SUCCESSİşlem başarılı, para çekildi
ERRORİşlem başarısız
NEWBaşlatılmış ama tamamlanmamış işlem (ödeme alınmamış, CompletePayment çağrılmamış)
TRANSACTION_TYPEAnlamı
SALESSatış işlemi
cancelİptal işlemi
refundİade işlemi

Son güncelleme: 5 Eylül 2026

v3 · Versiyonlar