Danh sách giao dịch

API Reference Cập nhật: 23/03/2026

Danh sách giao dịch

GET /api/v1/transactions
Authorization: Bearer YOUR_API_KEY

Lấy danh sách giao dịch với bộ lọc theo ngày, loại giao dịch, ngân hàng.

Query Parameters

Param	Kiểu	Bắt buộc	Mô tả
`from`	string	Không	Từ ngày (Y-m-d). VD: `2026-03-01`
`to`	string	Không	Đến ngày (Y-m-d). VD: `2026-03-31`
`type`	string	Không	`IN` (tiền vào), `OUT` (tiền ra). Không truyền = tất cả.
`bank_code`	string	Không	Lọc theo mã ngân hàng: `ACB`, `VCB`, `BIDV`...
`per_page`	integer	Không	Số bản ghi mỗi trang. Mặc định: 20, tối đa: 100.
`page`	integer	Không	Số trang. Mặc định: 1.

Response thành công

{
  "status": true,
  "messages": "Thành công",
  "transactions": [
    {
      "id": 35,
      "transaction_date": "2026-03-22 19:34:47",
      "transaction_id": "42923",
      "account_number": "7465441",
      "bank": "ACB",
      "amount": 25000,
      "description": "DH001234 Thanh toan don hang",
      "type": "IN",
      "checksum": "1d5d31b576877bf7d49dc48d08138066"
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 20,
    "total": 35,
    "last_page": 2
  }
}

Mô tả trường giao dịch

Trường	Kiểu	Mô tả
`id`	integer	ID giao dịch
`transaction_date`	string	Thời gian giao dịch (Y-m-d H:i:s)
`transaction_id`	string	Mã giao dịch từ ngân hàng
`account_number`	string	Số tài khoản
`bank`	string	Mã ngân hàng (ACB, VCB, BIDV, MBB, CTG)
`amount`	integer	Số tiền (VND)
`description`	string	Nội dung chuyển khoản
`type`	string	`IN` (tiền vào) hoặc `OUT` (tiền ra)
`checksum`	string	Mã duy nhất theo giao dịch — dùng kiểm tra trùng lặp

Response lỗi

{
  "status": false,
  "error": {
    "code": "INVALID_KEY",
    "message": "Invalid API key"
  }
}

Ví dụ cURL

curl -s "https://thueapi.vn/api/v1/transactions?from=2026-03-01&to=2026-03-31&type=IN" \
  -H "Authorization: Bearer YOUR_API_KEY"

Ví dụ PHP

$response = Http::withToken($apiKey)
    ->get("https://thueapi.vn/api/v1/transactions", [
        "from" => "2026-03-01",
        "to" => "2026-03-31",
        "type" => "IN",
        "per_page" => 50,
    ]);

$transactions = $response->json()["transactions"];