Image
account_info_banner
Image
icon thong tin tai khoan
Product introduction

Thông qua các API liên quan đến tài khoản, người dùng có thể truy xuất các thông tin chi tiết như số dư tài khoản, lịch sử giao dịch theo một khoảng thời gian nhất định,... để kiểm tra và nắm bắt thông tin các giao dịch đã thực hiện trên tài khoản.

- Khách hàng chủ động trong việc theo dõi thông tin tài khoản, nắm bắt thông tin về tài khoản chính xác

- Cập nhật thông tin tài khoản nhanh chóng, kịp thời.

- Có thể tự động hóa quy trình đối chiếu và quản lý tài khoản.

- Hỗ trợ ra các quyết định sáng suốt và kịp thời trong việc quản lý tiền mặt dựa vào thông tin thực tế.

- Kiểm tra lịch sử giao dịch khi cần xác minh các giao dịch trước đó hoặc kiểm tra thông tin giao dịch cụ thể.

- Thường xuyên kiểm tra lịch sử giao dịch giúp nhanh chóng phát hiện các giao dịch không phù hợp hoặc bất thường, từ đó có biện pháp bảo vệ tài khoản kịp thời.

- Kiểm tra lịch sử giao dịch giúp theo dõi tình trạng thực hiện các giao dịch tài chính cá nhân.

- Khách hàng đã có tài khoản tiền gửi thanh toán tại ACB và có trạng thái vẫn còn hoạt động.

- Khách hàng phải là chủ sở hữu của tài khoản truy xuất thông tin.

- Tài khoản đã được đăng ký sử dụng dịch vụ tại ACB.

- Đối với truy vấn lịch sử giao dịch, khách hàng cần có tài khoản tại ACB và tài khoản phải có phát sinh giao dịch.

1. Quy trình truy vấn thông tin liên quan đến tài khoản

account_info_wf_2

#Bước

Mô tả

Bước 1: Gửi yêu cầu truy vấn thông tin tài khoản

Khách hàng muốn truy vấn thông tin liên quan đển tài khoản thì có thể thực hiện gọi các API sau:

- API Truy vấn thông tin số dư tài khoản

- API Truy vấn danh sách giao dịch

- API Truy vấn lịch sử giao dịch

Bước 2: Nhận thông tin dữ liệu trả về

Hệ thống xử lý dữ liệu và gửi thông tin truy vấn về cho khách hàng.

2. Các chức năng đối với truy vấn lịch sử giao dịch

STT

Chức năng

Trường thông tin bắt buộc

1

Truy vấn lịch sử giao dịch theo khoản số giao dịch trong khoản thời gian
  • account
  • from_transaction_number
  • to_transaction_number
  • from_date
  • to_date

2

Truy vấn tất cả giao dịch trong khoản thời gian
  • account
  • from_date
  • to_date        

3

Truy vấn lịch sử giao dịch gần nhất theo giới hạn.
  • account
  • limit  
Errors list

#

HTTP Status Code 

Response Code

Response Error Code

Description English

1200 20000000000 Success 
240140142020186Missing token
340140142020182Invalid token
420240040020400Some Inputs are missing
520240340020403Permission denied
620240040020404Client Params is invalid
720250040020500Internal server error
820240042020018 Bad request format 
920240442020006The account not found 
Kịch bản kiểm thử

Tải tài liệu

1. Truy vấn danh sách giao dịch

STT

Tính năng

Mô tả tình huống

Điều kiện

Kết quả mong đợi

1

Truy vấn danh sách giao dịchTruy vấn danh sách giao dịch thành công- Fromdate = todate
- Account number hợp lệ
- Ngày truy vấn có phát sinh giao dịch		Http code: 200
Data trả về chi tiết giao dịch

2

Truy vấn danh sách giao dịchTruy vấn danh sách giao dịch không có dự liệu- Fromdate = todate
- Account number hợp lệ
- Ngày truy vấn không có phát sinh giao dịch		Http code: 200
Data rỗng

3

Truy vấn danh sách giao dịchTruy vấn danh sách giao dịch thất bại- Sai định dạng ngày
- Hoặc page, size không hợp lệ		Http code: 202
Error code: 42020018
Message: Bad request format

4

Truy vấn sanh sách giao dịchTruy vấn danh sách giao dịch thất bại- Fromdate khác todate
- Account number hợp lệ		Http code: 202
Error code: 42020018
Message: Bad request format

5

Truy vấn danh sách giao dịchTruy vấn danh sách giao dịch thất bại- Fromdate = todate
- Account number không thuộc khách hàng		Http code: 202
Error code: 42020006
Message: The account not found

6

Truy vấn danh sách giao dịchTruy vấn danh sách giao dịch thất bại- Token hết hạnHttp code: 401
Error code: 42020183
Message: Token is expired

2. Truy vấn thông tin số dư tài khoản 

 

STT

Tính năng

Mô tả tình huống

Điều kiện

Kết quả mong đợi

1

Truy vấn số dư tài khoảnTruy vấn số dư tài khoản thành công- Account number hợp lệHttp code: 200
Data trả về có current_balance và available_balance

2

Truy vấn số dư tài khoảnTruy vấn số dư thất bại- Account number không thuộc khách hàngHttp code: 202
Error code: 42020006
Message: The account not found

3

Truy vấn số dư tài khoảnTruy vấn số dư thất bại
  • Không nhập account number
Http code: 202
Error code: 42020018
Message: Bad request format

4

Truy vấn số dư tài khoảnTruy vấn số dư thất bại- Token hết hạnHttp code: 401
Error code: 42020183
Message: Token is expired

3. Truy vấn lịch sử giao dịch

STT

Tính năng

Mô tả tình huống

Điều kiện

Kết quả mong đợi

1

Truy vấn lịch sử giao dịch theo khoảng số giao dịch trong khoảng thời gianTruy vấn lịch sử giao dịch thành công

Yêu cầu ràng buộc của các trường theo danh sách bên dưới:

  • account = Required
  • from_transaction_number = Required
  • to_transaction_number = Required
  • from_date = Required
  • to_date = Required
  • limit = Not submit

 

Thực hiện truy vấn thành công

Mã trả về: 200 OK 

2

Truy vấn lịch sử giao dịch theo khoảng số giao dịch trong khoảng thời gianTruy vấn lịch sử giao dịch thất bại

Yêu cầu ràng buộc => đổi sang không ràng buộc của các trường theo danh sách bên dưới:

  • account = Required
  • from_transaction_number = Required
  • to_transaction_number = Not submit
  • from_date = Required
  • to_date = Required
  • limit = Not submit

Mã trả về: 400 - 40020400

some inputs are missing

3

Truy vấn các giao dịch trong khoản thời gianTruy vấn lịch sử giao dịch thành công

Yêu cầu ràng buộc của các trường theo danh sách bên dưới:

  • account = Required
  • from_transaction_number = Not submit
  • to_transaction_number = Not submit
  • from_date = Required
  • to_date = Required
  • limit = Not submit

Thực hiện truy vấn thành công

Mã trả về: 200 OK 

4

Truy vấn các giao dịch trong khoản thời gianTruy vấn lịch sử giao dịch thất bại

Yêu cầu ràng buộc => đổi sang không ràng buộc của các trường theo danh sách bên dưới:

  • account = Required
  • from_transaction_number = Not submit
  • to_transaction_number = Not submit
  • from_date = Not submit
  • to_date = Not submit
  • limit = Not submit

Thực hiện truy vấn không thành công

Mã trả về: 400 - 40020400

some inputs are missing

5

Truy vấn lịch sử giao dịch gần nhất theo giới hạnTruy vấn lịch sử giao dịch thành công

Yêu cầu ràng buộc của các trường theo danh sách bên dưới:

  • account = Required
  • from_transaction_number = Not submit
  • to_transaction_number = Not submit
  • from_date = Not submit
  • to_date = Not submit
  • limit = Required

Thực hiện truy vấn thành công

Mã trả về: 200 OK 

6

Truy vấn lịch sử giao dịch gần nhất theo giới hạnTruy vấn lịch sử giao dịch thất bại

Yêu cầu ràng buộc => đổi sang không ràng buộc của các trường theo danh sách bên dưới:

  • account = Required
  • from_transaction_number = Not submit
  • to_transaction_number = Not submit
  • from_date = Not submit
  • to_date = Not submit
  • limit = Not submit

Thực hiện truy vấn không thành công

Mã trả về: 400 - 40020400

 

7

Truy vấn lịch sử giao dịchTruy vấn giao dịch thất bại- Token hết hạnError code: 42020183
Message: Token is expired

8

Truy vấn lịch sử giao dịchTruy vấn giao dịch thất bại- Sai định dạng ngày
Error code: 42020018
Message: Bad request format
Main feature
account_infor_icon_1
Truy vấn lịch sử giao dịch
account_infor_icon_2
Truy vấn số dư tài khoản
key mapping
account-information
Mô tả
Thông qua các API liên quan đến tài khoản, người dùng có thể truy xuất các thông tin chi tiết như số dư tài khoản, lịch sử giao dịch theo một khoảng thời gian nhất định,...
API Order
accounts-balances|accounts-statements|accounts-transaction-history|current-accounts-statements|current-accounts-statements-callback