Tổng quan
API giao dịch hoạt động thế nào?
Mỗi tài khoản ngân hàng sau khi thêm thành công sẽ có token truy cập. Ứng dụng của bạn gọi endpoint tương ứng để lấy danh sách giao dịch mới nhất và sử dụng các trường số tiền, nội dung, mã giao dịch để xử lý nghiệp vụ.
https://thueapibank.vnXác thực bằng token
Token nằm ở phần quản lý tài khoản ngân hàng. Tùy phiên bản, token được đặt ở cuối đường dẫn. Hãy gọi API từ máy chủ của bạn và không để token xuất hiện trong mã JavaScript phía trình duyệt.
Không đưa token vào Git, ảnh chụp màn hình, log công khai hoặc URL theo dõi của bên thứ ba. Tạo token mới ngay khi nghi ngờ bị lộ.
Request đầu tiên
curl --request GET \
"https://thueapibank.vn/historyapivcbv2/YOUR_TOKEN" \
--header "Accept: application/json"Cấu trúc phản hồi
Tên trường chi tiết có thể khác theo ngân hàng, nhưng dữ liệu cốt lõi luôn gồm trạng thái và danh sách giao dịch.
| Trường | Kiểu | Ý nghĩa |
|---|---|---|
status | string | Trạng thái xử lý request. |
transactions | array | Danh sách giao dịch tìm thấy. |
transactionID | string | Mã tham chiếu giao dịch. |
amount | number | Số tiền của giao dịch. |
description | string | Nội dung chuyển khoản. |
type | string | IN cho tiền vào, OUT cho tiền ra. |
Mã trạng thái cần xử lý
200Thành côngĐọc và lưu giao dịch chưa xử lý.
401Token không hợp lệKiểm tra token hoặc tạo lại token.
404Không tìm thấyKiểm tra đường dẫn và phiên bản API.
429Quá nhiều requestChờ theo Retry-After và dùng backoff.
5xxLỗi tạm thờiThử lại có giới hạn và ghi log để đối soát.
