Cas 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 Cas và cho phép Ứng dụng của bạn truy cập thông tin tài khoản thông qua Cas API.
Cas 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à Cas cung cấp.
Dùng thử, xem Cas Link Demo
Authentication
- API Key: x-client-id
- API Key: x-secret-key
- API Key: Authorization
Mã của đối tác được Cas.dev cung cấp. Liên hệ https://bankhub.dev để đăng ký và được hỗ trợ.
Security Scheme Type: | apiKey |
|---|---|
Header parameter name: | x-client-id |
Mã bảo mật đối tác được Cas.dev cung cấp. Liên hệ https://bankhub.dev để đăng ký và được hỗ trợ.
Security Scheme Type: | apiKey |
|---|---|
Header parameter name: | x-secret-key |
Mã truy cập của mỗi phân quyền.
Security Scheme Type: | apiKey |
|---|---|
Header parameter name: | Authorization |
Tổng quan
Cas Link sẽ trả về một publicToken sau đó thông tin này dùng để đổi lấy accessToken, và các Cas API sẽ dùng accessToken để xác thực yêu cầu truy cập thông tin.
Để 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 Cas 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 Cas Link
Để có thể mở giao diện Cas 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ở Cas 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 Cas 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 Cas 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 Cas 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ở Cas 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, Cas 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.