Tài liệu tích hợp V1 · V2 · V3

API Timo

API Timo cho phép ứng dụng đọc giao dịch và tự động phản hồi khi phát sinh khoản thu mới.

TIMO API

Tích hợp giao dịch Timo

API Timo cho phép ứng dụng đọc giao dịch và tự động phản hồi khi phát sinh khoản thu mới. Kết nối này phù hợp cho freelancer, cửa hàng số và hệ thống thanh toán gọn nhẹ.

Phương thứcGET

Định dạngJSON

Xác thựcToken

Phiên bảnV1, V2, V3

Tài liệu API theo phiên bản

Chọn phiên bản tương ứng trong trang quản lý tài khoản Timo để xem tham số và dữ liệu trả về.

GETV3Khuyên dùng
https://thueapibank.vn/historyapitimov3/PASSWORD/ACCOUNT_NUMBER/YOUR_TOKEN

Tham số cần thiết

Tham sốBắt buộcMô tả
PASSWORDMật khẩu hoặc mã xác thực kết nối.
ACCOUNT_NUMBERSố tài khoản Timo cần truy vấn.
YOUR_TOKENToken API được cấp trong trang quản lý.

Code mẫu

curl --request GET \
  "https://thueapibank.vn/historyapitimov3/PASSWORD/ACCOUNT_NUMBER/YOUR_TOKEN" \
  --header "Accept: application/json"

Response mẫu

{
  "status": "success",
  "message": "Thành công",
  "transactions": [
    {
      "type": "IN",
      "transactionID": "FT26091912345678",
      "amount": 450000,
      "description": "DH1024 THANH TOAN",
      "transactionDate": "2026-09-19 10:24:36"
    }
  ]
}

Response thực tế có thể bổ sung trường riêng của Timo. Luôn kiểm tra trường tồn tại trước khi đọc.

Luồng xử lý khuyến nghị

  1. 1
    Lưu mã giao dịch

    Dùng transactionID làm khóa chống xử lý trùng.

  2. 2
    Chỉ xử lý tiền vào

    Kiểm tra type === "IN" trước khi ghép đơn.

  3. 3
    Ghép đúng đơn hàng

    So khớp số tiền và mã đơn trong nội dung chuyển khoản.

  4. 4
    Đối soát lại

    Chạy tác vụ định kỳ để bù các webhook bị chậm hoặc thất bại.

Câu hỏi về API Timo

API Timo dùng để làm gì?

API giúp lấy dữ liệu giao dịch Timo dạng JSON để xác nhận chuyển khoản, cộng số dư và đối soát tự động.

Nên dùng phiên bản API nào?

Nên ưu tiên phiên bản mới nhất mà tài khoản của bạn đang hỗ trợ. V1 và V2 phù hợp tích hợp bằng token; V3 bổ sung thông tin tài khoản trong đường dẫn.

Có thể nhận giao dịch Timo qua webhook không?

Có. Sau khi thêm tài khoản, bạn có thể cấu hình URL webhook để hệ thống gửi sự kiện giao dịch mới về máy chủ của bạn.

Tài liệu liên quan