Errors

A comprehensive breakdown of all bankHub error codes

Grant errors

These errors often occur when values are not matched or when bankHub is not supported.

GRANT_LOGIN_REQUIRED: Thông tin đăng nhập đã thay đổi (username/password, xác thực thiết bị hoặc bật chặn đăng nhập từ website). Yêu cầu người dùng đăng nhập để cập nhật lại thông tin. Sử dụng cơ chế cập nhật để cập nhật lại trạng thái của đối tượng

GRANT_TOKEN_EXPIRED: Grant token đã hết hạn

GRANT_NOT_PERMIT_UPDATE: Không có quyền cập nhật tài khoản

GRANT_NOT_PERMISSION: Phân quyền này không có quyền truy cập thông tin hiện tại

GRANT_NOT_FOUND: Liên kết không tồn tại hoặc đã thu hồi

FI errors

FI_NOT_FOUND: Tổ chức tài chính không tồn tại.

FI_SERVICE_NOT_FOUND: Không tìm thấy dịch vụ của tổ chức tài chính

App errors

APP_NOT_FOUND: Tài khoản nhà phát triển không tìm thấy

Error schema

We use standard HTTP response codes for success and failure notifications, in addition to the bankHub specified error in the result returned with the errorType field.

With a successful result returning 2XX code, 40X will be a mistake due to miscommunication, and 50X is a bankHub system error.

  {
      "requestId": "Ve0KlkIJ3F_IdfgC",
      "errorCode": "GRANT_NOT_FOUND",
      "errorMessage": "Liên kết không tồn tại hoặc đã thu hồi",
      "errorType": "GRANT_ERROR"
  }