API Hủy liên kết tài khoản
Đặc tả endpoint DELETE /v1/bank-accounts/{id} thu hồi quyền truy cập (consent) và ngắt liên kết tài khoản ngân hàng khỏi đối tác.
Hủy liên kết sẽ thu hồi consent của người dùng, ngắt kết nối tới ngân hàng và dừng mọi thông báo biến động số dư của tài khoản đó. Thao tác này không thể hoàn tác — muốn dùng lại, người dùng phải thực hiện liên kết lại từ đầu.
Bảng tham số đường dẫn (Path)
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
id | string | Có | Mã tài khoản liên kết (account_id) cần hủy |
cURL hủy liên kết
curl -X DELETE "https://bankhub-api.hitechcloud.vn/v1/bank-accounts/acc_8899aabb" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"Phản hồi (200 OK)
{
"status": "success",
"data": {
"account_id": "acc_8899aabb",
"status": "unlinked",
"unlinked_at": "2026-10-31 10:05:00"
}
}DELETE
https://bankhub-api.hitechcloud.vn/v1/bank-accounts/{id}Kiểm thử tại chỗThu hồi consent và ngắt liên kết tài khoản. Thao tác không thể hoàn tác.
Tham số đường dẫn
Nên cho người dùng xác nhận lại trước khi gọi endpoint này, vì toàn bộ dữ liệu đồng bộ và IPN của tài khoản sẽ dừng ngay lập tức.
Hủy liên kết sẽ thu hồi consent của người dùng, ngắt kết nối tới ngân hàng và dừng mọi thông báo biến động số dư của tài khoản đó. Thao tác này không thể hoàn tác — muốn dùng lại, người dùng phải thực hiện liên kết lại từ đầu.
Bảng tham số đường dẫn (Path)
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
id | string | Có | Mã tài khoản liên kết (account_id) cần hủy |
DELETE
https://bankhub-api.hitechcloud.vn/v1/bank-accounts/{id}Kiểm thử tại chỗThu hồi consent và ngắt liên kết tài khoản. Thao tác không thể hoàn tác.
Tham số đường dẫn
Nên cho người dùng xác nhận lại trước khi gọi endpoint này, vì toàn bộ dữ liệu đồng bộ và IPN của tài khoản sẽ dừng ngay lập tức.
cURL hủy liên kết
curl -X DELETE "https://bankhub-api.hitechcloud.vn/v1/bank-accounts/acc_8899aabb" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"Phản hồi (200 OK)
{
"status": "success",
"data": {
"account_id": "acc_8899aabb",
"status": "unlinked",
"unlinked_at": "2026-10-31 10:05:00"
}
}