Reporting Service

With this service, you can check the accuracy of the transaction and whether the money has been withdrawn. Use Paynkolay Panel to list your transactions.

POST the control sx (your listing sx value), startDate, endDate, clientRefCode (your own reference code used in the transaction), hashData values as form-data in the Body to https://paynkolaytest.nkolayislem.com.tr/Vpos/Payment/PaymentList link.

If clientRefCode is sent empty, all transactions in the relevant date range are shown.

Click to download Postman Collection. You can see the codes of the language you use in Postman Code Snippet.

You can pull data for a maximum of one month.

Values that TRANSACTION_TYPE result can take:

cancel (cancellation transaction)
refund (refund transaction)
sales (sales transaction)

Values that STATUS result can take:

SUCCESS
ERROR
NEW (transaction that has been started but not finished, payment not received, complete payment method not called, still halfway through)

Click to calculate hash data.

Example of a failed transaction query response:

{
  "id": "",
  "result": {
    "RESPONSE_CODE": "2",
    "CORE_TRX_ID_RESERVED": "E74D",
    "RESPONSE_DATA": "Operation successful",
    "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"
      }
    ]
  }
}

To check the success of transactions with the relevant reference codes, you should verify the STATUS value. In the example below, two transactions are shown: one successful and one unsuccessful.

{
  "id": "",
  "result": {
    "RESPONSE_CODE": "2",
    "CORE_TRX_ID_RESERVED": "E74D",
    "RESPONSE_DATA": "Operation successful",
    "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"
      },
      {
        "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"
      }
    ]
  }
}