BankHub Link
Thông tin
bankhub Link là giao diện hiển thị cho khách hàng cuối tương tác để có thể liên kết tài khoản tài chính của họ vào bankHub và cho phép Ứng dụng của bạn truy cập thông tin tài khoản thông qua bankHub API.
bankHub Link sẽ xử lý việc xác thực tài khoản, xác thực thiết bị đăng nhập, và xử lý lỗi với mỗi Dịch vụ tài chính mà bankHub cung cấp.
Dùng thử, xem bankHub Link Demo
Authentication
- API Key: x-client-id
- API Key: x-secret-key
- API Key: Authorization
Security Scheme Type: | apiKey |
---|---|
Header parameter name: | x-client-id |
Security Scheme Type: | apiKey |
---|---|
Header parameter name: | x-secret-key |
Security Scheme Type: | apiKey |
---|---|
Header parameter name: | Authorization |
Tổng quan
bankHub Link sẽ trả về một publicToken
sau đó thông tin này dùng để đổi lấy accessToken
, và các bankHub API sẽ dùng accessToken
để xác thực yêu cầu truy cập thông tin.
![](https://pub-24a3eef67e5b45c6a029d53d6c3d5b09.r2.dev/static/img/howitworks/start.png)
![](https://pub-24a3eef67e5b45c6a029d53d6c3d5b09.r2.dev/static/img/howitworks/create-grant.png)
![](https://pub-24a3eef67e5b45c6a029d53d6c3d5b09.r2.dev/static/img/howitworks/input-or-scan.png)
![](https://pub-24a3eef67e5b45c6a029d53d6c3d5b09.r2.dev/static/img/howitworks/exchange.png)
![](https://pub-24a3eef67e5b45c6a029d53d6c3d5b09.r2.dev/static/img/howitworks/success.png)
Để có thể bắt đầu một quá trình liên kết một tài khoản tài chính bắt buộc phải gọi khởi tạo một grantToken
. Với grantToken
bạn có thể cấu hình thông tin như: truy vấn thông tin gì, ngôn ngữ(comming soon) và dịch vụ tài chính chúng tôi hỗ trợ. Một khi người dùng đăng nhập qua bankHub Link thì kết quả publicToken
sẽ được trả về trên redirectUri
, sau đó sẽ dùng thông tin này để đổi lấy accessToken
.
Cách dùng bankHub Link
Để có thể mở giao diện bankHub Link bạn cần có grantToken
, nếu chưa có, xem Tạo phân quyền
Sau khi đã có grantToken
bạn sẽ mở bankHub Link bằng cách thay đổi thông tin <GRANT_TOKEN>
ở link dưới và mở link đó lên, giao diện của bankHub Link sẽ được hiển thị và KH sẽ liên kết tài khoản tài chính ở đây.
https://dev.link.bankhub.dev?grantToken=<GRANT_TOKEN>&redirectUri=<https://your-domain.com/callback-uri>&iframe=false
Môi trường bankHub Link
Môi trường | Mô tả | Giá trị |
---|---|---|
Sandbox | Mã cấp quyền | https://dev.link.bankhub.dev |
Production | Sử dụng thông tin chính thức, và ứng dụng đã được phát hành | https://link.bankhub.dev |
Các thông số trên bankHub Link
Trường | Mô tả | Thông tin |
---|---|---|
grantToken | Mã phân quyền, thời hạn sử dụng 30 phút | API tạo POST /grant/token |
redirectUri | Đường dẫn điều hướng khi có kết quả | Kết quả publicToken sẽ được trả về trên đường dẫn này |
iframe | Mở bankHub Link trên bằng iframe | Mặc định là false |
Xử lý lỗi
Khi sử dụng một phân quyền(grant) trong thời gian dài trên ứng dụng của bạn sẽ gặp trường hợp thông tin tài khoản tài chính của khách hàng thay đổi dẫn đến khi gọi lấy tài nguyên không được. Với trường hợp này, bankHub Link hỗ trợ tính năng Update Mode để xử lý cập nhật các thông tin thay đổi như: mật khẩu, xác thực thiết bị. Xem chi tiết, Update Mode.