1. Giao dịch
HKS Partner VNVN API
  • VNVN Webhook Integration Guide
  • HKS Partner VNVN API
    • Ngân hàng
      • Lấy danh sách ngân hàng liên kết hệ thống
    • Xác minh tài khoản
      • Xác minh tài khoản ngân hàng qua VA
    • Thanh toán
      • Thanh toán / Giải ngân đến tài khoản ngân hàng
    • Giao dịch
      • Danh sách giao dịch của partner
        GET
      • Chi tiết giao dịch
        GET
    • Tài khoản
      • Thông tin tài khoản VA của partner
    • Schemas
      • TenNganHang
      • NganHangItem
      • DanhSachNganHangResponse
      • XacMinhTaiKhoanRequest
      • ThongTinTaiKhoan
      • KetQuaXacMinh
      • XacMinhTaiKhoanResponse
      • ChuyenKhoanRequest
      • KetQuaChuyenKhoan
      • ChuyenKhoanResponse
      • GiaoDichItem
      • PhanTrang
      • DanhSachGiaoDich
      • DanhSachGiaoDichResponse
      • ChiTietGiaoDichResponse
      • ThongTinVATaiKhoan
      • LỗiValidation
      • ThongTinVATaiKhoanResponse
      • LỗiXácThực
      • LỗiKhôngTìmThấy
      • LỗiQuáNhiềuRequest
      • LỗiMáyChủ
      • LỗiTrùngRequest
  1. Giao dịch

Danh sách giao dịch của partner

GET
/partner/vnvn/transactions
Trả về danh sách giao dịch có phân trang của partner đang xác thực. Hỗ trợ lọc theo loại, hướng, trạng thái và khoảng thời gian.

Request

Authorization
API Key
Add parameter in header
x-api-key
Example:
x-api-key: ********************
or
Query Params

Responses

🟢200OK
application/json
Lấy danh sách giao dịch thành công
Bodyapplication/json

🟠400Bad Request
🟠401Unauthorized
🔴500Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.itax.dev/partner/vnvn/transactions?page=1&limit=10&type=TRANSFER_OUT&direction=OUT&status=SUCCESS&fromDate=2026-01-01T00%3A00%3A00.000Z&toDate=2026-12-31T23%3A59%3A59.999Z' \
--header 'x-api-key: <api-key>'
Response Response Example
200 - Success Example
{
    "statusCode": 200,
    "message": "Partner transactions retrieved successfully",
    "data": {
        "items": [
            {
                "id": "cm4abcd1234",
                "transactionCode": "ITAX_TXN_user123_TRANSFER_OUT_1747030000000",
                "type": "TRANSFER_OUT",
                "direction": "OUT",
                "status": "SUCCESS",
                "amount": "100000.00",
                "feeAmount": "0.00",
                "totalAmount": "100000.00",
                "balanceBefore": "1000000.00",
                "balanceAfter": "900000.00",
                "description": "HPVN Thanh toan don hang 001",
                "bankCode": "970423",
                "bankName": "TPB",
                "bankAccountNumber": "dohoangtien",
                "bankAccountName": "DO HOANG TIEN",
                "createdAt": "2026-05-12T10:00:00.000Z",
                "updatedAt": "2026-05-12T10:01:00.000Z",
                "completedAt": "2026-05-12T10:01:00.000Z"
            }
        ],
        "meta": {
            "total": 1,
            "page": 1,
            "limit": 10,
            "totalPages": 1,
            "hasNext": false,
            "hasPrev": false
        }
    }
}
Modified at 2026-05-13 14:44:08
Previous
Thanh toán / Giải ngân đến tài khoản ngân hàng
Next
Chi tiết giao dịch
Built with