Hướng dẫn đăng ký và sử dụng ThueAPI.VN từ A-Z

Bắt đầu với ThueAPI.VN chỉ trong 10 phút

Bài viết này hướng dẫn bạn từng bước để bắt đầu sử dụng ThueAPI.VN - từ đăng ký tài khoản đến nhận giao dịch đầu tiên. Không cần kiến thức kỹ thuật chuyên sâu.

Bước 1: Đăng ký tài khoản

Truy cập thueapi.vn và nhấn nút "Bắt đầu miễn phí".

Bạn có 2 cách đăng ký:

Email + Mật khẩu: Điền email, tên đăng nhập, mật khẩu
Google OAuth: Đăng nhập nhanh bằng tài khoản Google

Sau khi đăng ký, bạn được dùng thử miễn phí 7 ngày gói Nano với đầy đủ tính năng cơ bản. Không cần thanh toán.

Bước 2: Kết nối tài khoản ngân hàng

Sau khi đăng nhập, vào Dashboard → Tài khoản ngân hàng → Thêm tài khoản.

Giao diện Dashboard sau khi đăng nhập:

Chọn mục Tài Khoản ngân hàng để thêm ngân hàng.

Hướng dẫn dùng API Ngân hàng ACB.
Hướng dẫn dùng API Ngân hàng BIDV.
Hướng dẫn dùng API Ngân hàng Vietcombank.
Hướng dẫn dùng API Ngân hàng MB Bank.
Hướng dẫn dùng API Ngân hàng Vietinbank.

ThueAPI hỗ trợ 2 loại kết nối:

Loại kết nối	Thông tin cần có	Ngân hàng hỗ trợ
Personal	Tài khoản Internet Banking (username, password)	VCB, CTG, BIDV, MBB
Open API	Thông tin KYC (CCCD, SĐT, email)	ACB

Chọn ngân hàng → Điền thông tin → Xác nhận OTP từ ngân hàng → Hoàn tất.

Bước 3: Lấy API Key

Vào Dashboard → API Keys để tạo và quản lý API key. Mỗi API key là một chuỗi ký tự duy nhất dùng để xác thực khi gọi API.

Lưu ý bảo mật:

Không chia sẻ API key cho bên thứ ba
Có thể tạo nhiều API key cho các mục đích khác nhau
Vô hiệu hóa key ngay nếu nghi ngờ bị lộ

Bước 4: Thiết lập Webhook

Webhook là cách ThueAPI gửi thông báo giao dịch đến hệ thống của bạn. Vào Dashboard → Webhooks → Tạo webhook.

Điền thông tin:

URL: Endpoint nhận webhook (VD: https://your-site.com/api/webhook/thueapi)
Secret Key: Khóa bảo mật để xác thực webhook
Rules: Quy tắc lọc giao dịch (prefix matching)