Mã lỗi BankHub
Mã lỗi BankHub HiTechCloud Pay: bảng mã HTTP, mã lỗi nghiệp vụ và sự kiện lỗi trong luồng Hosted Link kèm cách xử lý từng trường hợp.
API BankHub trả lỗi theo chuẩn HTTP kèm phần thân JSON mô tả chi tiết. Hãy luôn kiểm tra mã trạng thái HTTP và trường error.code để xử lý phù hợp.
Cấu trúc phản hồi lỗi
Ví dụ thân lỗi
{
"status": "error",
"error": {
"code": "ACCOUNT_NOT_FOUND",
"message": "Không tìm thấy tài khoản liên kết với id đã cho",
"request_id": "req_7f3a9b22"
}
}Mã trạng thái HTTP
| HTTP | Ý nghĩa | Nguyên nhân thường gặp |
|---|---|---|
400 | Bad Request | Thiếu tham số bắt buộc hoặc sai định dạng body |
401 | Unauthorized | Access Token sai, hết hạn hoặc thiếu header Authorization |
403 | Forbidden | Token không có quyền (scope) truy cập tài nguyên |
404 | Not Found | account_id hoặc tài nguyên không tồn tại |
409 | Conflict | Tài khoản đã được liên kết trước đó |
429 | Too Many Requests | Vượt giới hạn tần suất gọi (rate limit) |
500 | Internal Server Error | Lỗi phía BankHub, thử lại sau hoặc liên hệ hỗ trợ |
503 | Service Unavailable | Ngân hàng đang bảo trì hoặc tạm thời không kết nối được |
Mã lỗi nghiệp vụ
| error.code | Mô tả | Hướng xử lý |
|---|---|---|
INVALID_CREDENTIALS | Sai Client ID/Secret khi lấy token | Kiểm tra lại thông tin đối tác |
LINK_TOKEN_EXPIRED | Link Token quá 30 phút | Tạo Link Token mới |
ACCOUNT_NOT_FOUND | Không tìm thấy tài khoản liên kết | Đồng bộ lại danh sách tài khoản |
BANK_UNAVAILABLE | Ngân hàng đang bảo trì | Thử lại sau, báo người dùng |
CONSENT_REVOKED | Người dùng đã thu hồi quyền | Yêu cầu người dùng liên kết lại |
RATE_LIMIT_EXCEEDED | Vượt giới hạn tần suất | Giãn tần suất gọi, dùng cache số dư |
Luôn ghi lại
request_id trong log của bạn — khi cần hỗ trợ, cung cấp mã này giúp đội kỹ thuật HiTechCloud tra cứu nhanh nguyên nhân.API BankHub trả lỗi theo chuẩn HTTP kèm phần thân JSON mô tả chi tiết. Hãy luôn kiểm tra mã trạng thái HTTP và trường error.code để xử lý phù hợp.
Cấu trúc phản hồi lỗi
Mã trạng thái HTTP
| HTTP | Ý nghĩa | Nguyên nhân thường gặp |
|---|---|---|
400 | Bad Request | Thiếu tham số bắt buộc hoặc sai định dạng body |
401 | Unauthorized | Access Token sai, hết hạn hoặc thiếu header Authorization |
403 | Forbidden | Token không có quyền (scope) truy cập tài nguyên |
404 | Not Found | account_id hoặc tài nguyên không tồn tại |
409 | Conflict | Tài khoản đã được liên kết trước đó |
429 | Too Many Requests | Vượt giới hạn tần suất gọi (rate limit) |
500 | Internal Server Error | Lỗi phía BankHub, thử lại sau hoặc liên hệ hỗ trợ |
503 | Service Unavailable | Ngân hàng đang bảo trì hoặc tạm thời không kết nối được |
Mã lỗi nghiệp vụ
| error.code | Mô tả | Hướng xử lý |
|---|---|---|
INVALID_CREDENTIALS | Sai Client ID/Secret khi lấy token | Kiểm tra lại thông tin đối tác |
LINK_TOKEN_EXPIRED | Link Token quá 30 phút | Tạo Link Token mới |
ACCOUNT_NOT_FOUND | Không tìm thấy tài khoản liên kết | Đồng bộ lại danh sách tài khoản |
BANK_UNAVAILABLE | Ngân hàng đang bảo trì | Thử lại sau, báo người dùng |
CONSENT_REVOKED | Người dùng đã thu hồi quyền | Yêu cầu người dùng liên kết lại |
RATE_LIMIT_EXCEEDED | Vượt giới hạn tần suất | Giãn tần suất gọi, dùng cache số dư |
Luôn ghi lại
request_id trong log của bạn — khi cần hỗ trợ, cung cấp mã này giúp đội kỹ thuật HiTechCloud tra cứu nhanh nguyên nhân.Ví dụ thân lỗi
{
"status": "error",
"error": {
"code": "ACCOUNT_NOT_FOUND",
"message": "Không tìm thấy tài khoản liên kết với id đã cho",
"request_id": "req_7f3a9b22"
}
}