Skip to main content

Update mode

POST 
/grant/token

Cập nhật grant (phân quyền) thông qua Link

Sử dụng Update mode để cập nhật phân quyền hoặc để xử lý trạng thái lỗi GRANT_LOGIN_REQUIRED.

Khi nào thì sử dụng Update mode​

Update mode được dùng để cập nhật xác thực hoặc uỷ quyền cho một phân quyền. Thường sử dụng khi quyền truy cập phân quyền ngừng hoạt động gồm: người dùng thay đổi mật khẩu tài khoản tài chính, tài khoản tài chính cần xác thực 2 yếu tố (MFA) hoặc tài khoản bị khoá.

Xử lý mã lỗi GRANT_LOGIN_REQUIRED​

Khi nhận được thông tin lỗi GRANT_LOGIN_REQUIRED, thì phân quyền(grant) đó cần được tạo lại thông qua Update Mode.

Nếu nhận được mã lỗi GRANT_LOGIN_REQUIRED sau khi gọi qua bankHub API, bạn cần mở bankHub Link ở chế độ Update mode cho người dùng và yêu cầu người dùng thực hiện lại bước xác thực trước khi tiếp tục gọi qua bankHub API.

Nếu nhận được mã lỗi GRANT_LOGIN_REQUIRED thông qua webhook, thì cần xác thực lại bằng bankHub Link ở chế độ Update mode khi người dùng truy cập lần nữa trên ứng dụng của bạn. Bạn sẽ cần thông báo với người dùng quay lại ứng dụng của bạn để thực hiện thao tác kết nối lại.

Cách sử dụng Update Mode​

Để sử dụng Update mode cho một phân quyền (grant), cần tạo bankHub Link với accessToken được gắn với grantId mà bạn muốn cập nhật.

Update Mode thường dùng để cập nhật thông tin liên quan tài khoản dịch vụ tài chính, nhưng khi trạng thái của TK trên hệ thống bankHub đang là Kết nối thì lúc gọi Update Mode sẽ gặp lỗi là FI_SERVICE_ACCOUNT_CONNECTING và không cần cập nhật. Để kiểm tra trạng thái hiện tại là chính xác, bạn có thể gọi API /identity để kiểm tra thông tin đăng nhập hiện tại trên bankHub là hợp lệ. Nếu gặp lỗi GRANT_LOGIN_REQUIRED thì bạn có thể gọi Update Mode như bình thường.

Request​

Responses​

Thành công