Production checklist

Danh sách các bước được đề xuất cần hoàn thành trước khi tung sản phẩm cho người dùng

Các bước dưới đây là danh sách được bankHub đề xuất cần thực hiện trước khi triển khai tích hợp bankHub trên môi trường Production. Có thể một vài bước không quan trọng nhưng hoàn thành các bước sau sẽ giúp việc tích hợp bankHub trên sản phẩm của bạn được đảm bảo hoạt động ổn định, an toàn và dễ bảo trì.

Thiết lập trên Production

Đã có tài khoản trên https://console.bankhub.dev

Đảm bảo bạn đang sử dụng thông tin secret của production, thông tin về secret key bạn có thể xem trên https://console.bankhub.dev

Cấu hình cho bankHub Link và server code sử dụng thông tin của môi trường production, bằng cách thay đổi giá trị các API key khi gửi request đến bankHub.

Thêm và cấp quyền truy cập cho thành viên, chi tiết bankHub teams

Thiếp lập bankHub Link

Chắc chắn phần tích hợp Oauth hoạt động

Để tránh tính phí không cần thiết và gây nhầm lẫn cho người dùng, nên triển khai logic tránh duplicate Grant(cấp quyền).

Đảm bảo tham số scopes của /grant/token chỉ bao gồm những quyền bạn muốn sử dụng.

Cấu hình Webhook

bankHub sử dụng webhook cho nhiều luồng thông thường. Để ứng dụng của bạn hoạt động mượt mà khi tích hợp bankHub thì webhook cần được thiết lập.

Chắc chắn bạn đã nhận được các webhook từ bankHub webhook IPs

Xem lại bankHub webhook để đảm bảo logic xử lý webhook của bạn chính xác khi hệ thống không ổn định hoặc lượng truy cập tăng đột biến.

Xử lý lỗi

Thỉnh thoảng, gọi bankHub API không thành công do hệ thống gián đoạn hoặc lỗi kết nối tới các tổ chức tài chính. Cần triển khai retry logic hoặc xử lý lỗi phú hợp.

Update mode

Update mode(chế độ cập nhật) được sử dụng để cập nhật các thay đổi của tài khoản được cấp quyền(ví dụ: người dùng thay đổi mật khẩu tài khoản). Nếu ứng dụng của bạn cần truy cập nhiều lần thông tin tài khoản thông qua phân quyền, thay vì chỉ cần liên kết, thì bạn cần triển khai logic Update mode.

Xử lý lỗi GRANT_LOGIN_REQUIRED của Grant bằng cách chạy Grant với Update mode để cho khách hàng của bạn có thể truy cập thông tin mà không bị gián đoạn. Chi tiết, Update mode

Quản lý Grant

Xoá Grant bằng cách sử dụng /grant/remove khi các phân quyền đó không còn được sử dụng. Ví dụ: bạn cho phép người dùng xoá liên kết tài khoản tài chính thông qua giao diện ứng dụng của bạn.

Lưu trữ & logging

Lưu trữ log đúng cách để tăng cường xử lý sự cố và bảo mật khi liên hệ với đội ngũ hỗ trợ về một yêu cầu hoặc callback, cũng như tìm kiếm trong Logs.

Access Token và Grant ID là các định danh cốt lõi gắn trực tiếp với tài khoản tài chính của khách hàng. Lưu chúng ở nơi an toàn và liên kết tài khoản với người dùng trên ứng dụng của bạn. Đảm bảo không hiển thị thông tin này ở giao diện ứng dụng. Và một người dùng có thể tạo nhiều Grant(cấp quyền) nếu người dùng có nhiều tài khoản tài chính.

Chắc chắn đã lưu trữ các định danh phía dưới ở nơi an toàn, vì chúng sẽ cần thiết khi liên hệ với bộ phận hỗ trợ về chi tiết một yêu cầu hoặc callback.

requestId: Được trả về trên tất cả các Response của bankHub API

grantId: Được trả về trên tất cả các Response của bankHub API thành công liên quan tới một Grant(cấp quyền).

Xử lý chung

Đã xử lý USER_PERMISSION_REVOKED từ webhook của Grant khi một Grant(cấp quyền) hoặc tài khoản tài chính bị xoá trên bankHub Mobile.

Đã xử lý webhook của Grant với mã DEFAULT_UPDATE, giá trị được gửi khi tài khoản tài chính gắn với Grant(cấp quyền) đã kết nối lại.