İşlem Doğrulama Servisi

Bu servis ile işlemin doğruluğunu, paranın çekilip çekilmediğini kontrol edebilirsiniz. İşlemlerinizi listelemek için Paynkolay Panel'i kullanınız.

clientRefCode boş gönderilirse ilgili tarih aralığındaki tüm işlemler gösterilir. En fazla bir aylık data çekebilirsiniz. Doğru sonuç için bu kodu her işlemde benzersiz gönderin; aksi halde aynı koda sahip birden fazla işlem birlikte döner.

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

Body multipart/form-data

	Parametre	Değer	Açıklama
	`sx` zorunlu		Listeleme Sx değeriniz.
	`startDate` zorunlu		Başlangıç tarihi (DD.MM.YYYY)
	`endDate` zorunlu		Bitiş tarihi (DD.MM.YYYY)
	`clientRefCode` opsiyonel		İşlemde kullandığınız kendi referans kodunuz. Her işlem için benzersiz göndermeniz önerilir; aksi halde sorgulama bu kodu paylaşan tüm işlemleri döndürür.
	`hashDatav2` zorunlu		Hash değeri (otomatik hesaplanır). Formül: `sx \| startDate \| endDate \| clientRefCode \| merchantSecretKey` merchantSecretKey: String: Base64 (SHA-512):

{
  "id": "",
  "result": {
    "RESPONSE_CODE": "2",
    "CORE_TRX_ID_RESERVED": "E74D",
    "RESPONSE_DATA": "İşlem başarılı",
    "sessionId": "50-bf-4b-e",
    "LIST": [
      {
        "REFERENCE_CODE": "IKSIRPF419782",
        "AUTH_CODE": "",
        "COMMISION": "0.0100",
        "CARD_BANK_CODE": "010",
        "USER_EMAIL": "hayalevi",
        "AUTHORIZATION_AMOUNT": "1.00",
        "OID": "0769CE1-31C607C",
        "POS_TYPE": "Sanal POS",
        "TRANSACTION_TYPE": "SALES",
        "IS_3D": true,
        "MERCHANT_COMMISSION_AMOUNT": "0.00",
        "TRANSACTION_AMOUNT": "1.00",
        "CARD_HOLDER_NAME": "test",
        "VALOR_DATE": "20241226",
        "CLIENT_REFERENCE_CODE": "114488212|5553901555",
        "STATUS": "SUCCESS",
        "TRX_DATE": "24.12.2024 16:09:25",
        "DESCRIPTION": "",
        "TERMINAL_NAME": "ZIRAATBANK",
        "CARD_BANK_NAME": "T.C.ZİRAAT BANKASI",
        "INSTALLMENT_COUNT": "1"
      }
    ]
  }
}

{
  "id": "",
  "result": {
    "RESPONSE_CODE": "2",
    "CORE_TRX_ID_RESERVED": "E74D",
    "RESPONSE_DATA": "İşlem başarılı",
    "sessionId": "50-bf-4b-e",
    "LIST": [
      {
        "REFERENCE_CODE": "IKSIRPF419781",
        "AUTH_CODE": "",
        "COMMISION": "0.0100",
        "CARD_BANK_CODE": "010",
        "USER_EMAIL": "hayalevi",
        "AUTHORIZATION_AMOUNT": "1.00",
        "OID": "0769CE1-31C607C",
        "POS_TYPE": "Sanal POS",
        "TRANSACTION_TYPE": "SALES",
        "IS_3D": true,
        "MERCHANT_COMMISSION_AMOUNT": "0.00",
        "TRANSACTION_AMOUNT": "1.00",
        "CARD_HOLDER_NAME": "test",
        "VALOR_DATE": "20241225",
        "CLIENT_REFERENCE_CODE": "114488219|5553901555",
        "STATUS": "ERROR",
        "TRX_DATE": "24.12.2024 16:09:21",
        "DESCRIPTION": "",
        "TERMINAL_NAME": "ZIRAATBANK",
        "CARD_BANK_NAME": "T.C.ZİRAAT BANKASI",
        "INSTALLMENT_COUNT": "1"
      }
    ]
  }
}

{
  "id": "",
  "result": {
    "RESPONSE_CODE": "2",
    "CORE_TRX_ID_RESERVED": "E74D",
    "RESPONSE_DATA": "İşlem başarılı",
    "sessionId": "50-bf-4b-e",
    "LIST": [
      {
        "REFERENCE_CODE": "IKSIRPF419781",
        "STATUS": "ERROR",
        "TRANSACTION_TYPE": "SALES",
        "AUTHORIZATION_AMOUNT": "1.00",
        "CLIENT_REFERENCE_CODE": "114488219|5553901555",
        "TRX_DATE": "24.12.2024 16:09:21",
        "CARD_HOLDER_NAME": "test",
        "IS_3D": true,
        "POS_TYPE": "Sanal POS",
        "CARD_BANK_NAME": "T.C.ZİRAAT BANKASI"
      },
      {
        "REFERENCE_CODE": "IKSIRPF419782",
        "STATUS": "SUCCESS",
        "TRANSACTION_TYPE": "SALES",
        "AUTHORIZATION_AMOUNT": "1.00",
        "CLIENT_REFERENCE_CODE": "114488212|5553901555",
        "TRX_DATE": "24.12.2024 16:09:25",
        "CARD_HOLDER_NAME": "test",
        "IS_3D": true,
        "POS_TYPE": "Sanal POS",
        "CARD_BANK_NAME": "T.C.ZİRAAT BANKASI"
      }
    ]
  }
}

Postman Collection'ını indirmek için tıklayınız. Postman Code Snippet'inde kendi kullandığınız dilin kodlarını görebilirsiniz.

TRANSACTION_TYPE sonucunun alabileceği değerler:

cancel ( iptal işlemi )
refund ( iade işlemi )
sales ( satış işlemi )

STATUS sonucunun alabileceği değerler:

SUCCESS
ERROR
NEW ( başlatılan ama bitirilmeyen, ödemesi alınmamış, complete payment methodu çağırılmamış, henüz yarıda kalmış işlem )

Hash datayı hesaplamak için tıklayınız.

İlgili referans kodlu işlemlerin başarısını görmek için STATUS değerini kontrol etmelisiniz.