6. Lấy danh sách giao dịch

- API path: /api/payment/v1/getTransaction

- Method: POST

- Mô tả: API do KLB Pay cung cấp dùng để lấy lịch sử giao dịch của tài khoản ảo.

Tham số trong Request Body

Key	Type	Require	Value
data	String	✓	Chứa dữ liệu đã được mã hóa

Các thông tin trường data lúc chưa mã hóa:

Key	Type	Require	Ý nghĩa
order	Number		Order của tài khoản ảo - null sẽ lấy toàn bộ giao dịch
page	Number		Trang hiện tại (Mặc định 0)
size	Number		Số lượng giao dịch trong trên 1 page (Mặc định 20)
bankAccountNo	String		Filter theo số tài khoản ngân hàng
fromDate	String		Filter giao dịch từ ngày
toDate	String		Filter giao dịch đến ngày

Tham số trong Response Body

Key	Type	Value
code	Number	Mã lỗi
message	String	Mô tả thông tin mã lỗi
data	String	Chứa dữ liệu đã được mã hóa

Các thông tin trường data lúc chưa mã hóa:

Key	Type	Value
code	Number	Mã lỗi
message	String	Mô tả thông tin mã lỗi
data	String	Chứa dữ liệu đã được mã hóa

Các thông tin trường items lúc chưa mã hóa:

Key	Type	Value
id	Number	Id
status	String	Trạng thái giao dịch
amount	String	Số tiền giao dịch
refTransactionId	Number	Mã giao dịch tham chiếu
createDateTime	String	Ngày thực hiện giao dịch
completeTime	String	Ngày hoàn thành giao dịch
virtualAccount	Number	Số tài khoản ảo
description	Number	Nội dung giao dịch
paymentType	Number	Loại giao dịch
txnNumber	Number	Mã giao dịch
accountName	Number	Tên tài khoản
accountNo	Number	Số tài khoản
interBankTrace	Number	Mã giao dịch ngân hàng

Ví dụ

• Request Mẫu
  • Request Body

      {
          "data": "uZEuAdQOZK6hMmedsHHrCcORLeW0UlzdduUVPTY7JrURjpWEU0GiCpbqiW/IEpSODMBfFkOcZ5mPzAlkNOpiqH91wGpaGbNkftTA0uzKO8HY9DSr1RKhCyfMGLS4RyrHcnhOv86REcouTc2rFX1lTpLucPd+UQnBxByoUfjSD5c="
      }
  • Giá trị trường data trước khi encrypt:

      {
        "bankAccountNo": "",
        "fromDate": "2023-07-10 00:00:00",
        "order": 2,
        "page": 0,
        "size": 10,
        "toDate": "2023-07-20 23:00:00"
      }
• Response mẫu
  • Response Data:

      {
        "code": 0,
        "data": "rMQkZ2DeLkI2lIuuIsSkGaXzHzyuyrTBRQwN28aZf6y3Se1fWG2ov2W5IM6to/AC7/HxU1icWe4q5Rds4DlU/BtN3uMUwoQtEuaQjod9st/pK2jMvBc5fhYAWe5cLWMLq6QZDtWq2Qi99b6dTbB3xGx/z/fuMqXOZMtKGCVowLxYRFQAD1fZVqscadBzt7KL2bjRBCmtfFcTbEMCanMASfiBPsxlvyyzTRZGMmrOwu+BWsNbRr4ScHNg4YhVTkDiQxIrhpVkkWsYHIt+P58E+DLqk1mHAA8j26qoiskqvCp5wvfUGlVzwLysLEhci60vjiohaDggGbPNNR61WpkGc7E3TisW3Dok5pm1zy4FxlSoyJJ2iOb42tuv0K5dpfQBrkNl63agEBz8XJsEPtrNFZ4ksorZx087KzRCOL2soF3z3879/iP9RdnDY+PngzeAnKxs3xscPB/MMWc0cD80UKFIDyQJByfzhHW6PR+TzDn0yge2+g8fNr1im5SzqcVKpek8rJUgDlzrpivgu4w7lXinVlt18xJ73QwnmcNKgOa0icUKj0+LgqVe7shGXVKoNt46wM1h08bgR4iLuqgbMfkRd8iEsX8D8blZD45NgHWXSYt9nEam1W6VabRONNnYLXxZqIuNa/6QF7vbuaurb/QJ9ipBWj1qjaA4pyyz701pllSP3coutmCCuyXnvBBUS0LtSRhiSm7RNjyDNcEkMCm9Gy0fdimAEcFy9mOQzflcMQ5+cef6QV7PRu4a/Q9i77uUuwM0UDQ9rkFl4YXC2O7TrJ0UgLmvhS68sSGMJInqOQHMWIZkfH5KNTvnDc58K3MpW6aJp/DOz+XcQhrfF9ZW42qc2a8PfGSuQ/6lGNcyJEm/OLteQBsNXRFAerR5O64aExyrQDaZtBa2U+caspVbbsO+faXcwgf/52ZTZaAcrCTiCgrcbvEc0vup7Vp/RyShtoo/Q6YV30HbQVCGakqIXCPsZABg87QbQ8xWzJFCmp5vkBPS8x75tGsZ+bhtICXzMksA87tWW718uKq/PoFkimqx5Cwh+s/Dt85090ueB5OTPJ6J0d9+sKTXF3xanArjKgoTLvdNk2C9M8Ds4StkddYIQ9hDMvDVLh0mNtG5dqJLTIOFkO8nTS4VZeV5",
        "message": "Success"
      }
  • Gía trị trường data trước khi encrypt:

      {
        "items": [
          {
            "id": "f22fcd1a-46fe-4f42-bc5f-8dc02915121e",
            "status": "SUCCESS",
            "amount": 100000,
            "refTransactionId": "",
            "createDateTime": "2023-07-19 17:30:20",
            "completeTime": "2023-07-19 17:30:20",
            "virtualAccount": "109399282792000020",
            "description": "[109399282792000020.4570834602] Payme",
            "paymentType": "VIET_QR",
            "txnNumber": "P00000000353",
            "accountName": "TRAN NGOC THANG",
            "accountNo": "4570834602",
            "interBankTrace": "057ZEXA2313500IW"
          },
          {
            "id": "1b15b159-e8a2-4c84-8c20-4e620377f171",
            "status": "SUCCESS",
            "amount": 1000000,
            "refTransactionId": "",
            "createDateTime": "2023-07-19 17:12:16",
            "completeTime": "2023-07-19 17:12:16",
            "virtualAccount": "109399282792000020",
            "description": "[109399282792000020.4570834602] Payme",
            "paymentType": "VIET_QR",
            "txnNumber": "P00000000351",
            "accountName": "TRAN NGOC THANG",
            "accountNo": "4570834602",
            "interBankTrace": "057ZEXA2313500IV"
          }
        ],
        "pageNumber": 0,
        "pageSize": 10,
        "totalPage": 1,
        "totalSize": 2
      }