Cas Link
Thông tin
Cas 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 cung cấp. Liên hệ https://cas.so để đă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 cung cấp. Liên hệ https://cas.so để đă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.
Cas Link là màn hình liên kết ngân hàng được tích hợp ngay trong ứng dụng của bạn. Khách hàng không cần rời khỏi app, vẫn sử dụng giao diện và thương hiệu của bạn. Cas xử lý toàn bộ phần đăng nhập ngân hàng, OTP và các lỗi phát sinh.
Luồng kết nối sẽ bắt đầu khi khách hàng muốn kết nối tài khoản tài chính của họ vào ứng dụng của bạn. Các bước thực hiện như sau:
Bấm nút “Liên kết ngân hàng” trong hình để xem luồng chạy. Rê chuột lên từng khối để xem giải thích.
- Khách hàng bấm “Liên kết ngân hàng” ngay trong ứng dụng của bạn.
- Gọi
POST /grant/tokenđể tạo một grantToken, rồi trả kết quả về giao diện ứng dụng của bạn. - Dùng grantToken để mở Cas Link cho khách hàng. Khi liên kết thành công, Cas trả về publicToken tạm thời.
- Gọi
POST /grant/exchangeđể đổi publicToken lấy accessToken và grantId tương ứng. - Lưu accessToken lại bất kỳ đâu bạn thấy an toàn và dùng cho việc gọi các API.
Để 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 |
| state | Chuỗi ngẫu nhiên do client tạo để chống CSRF/giữ ngữ cảnh | Được trả lại nguyên vẹn qua callback. Tham khảo |
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.