ACB cung cấp cho doanh nghiệp giải pháp Tài khoản định danh kiểm tra thông tin ghi có qua API giúp đảm bảo khoản thanh toán chính xác theo đối tượng hoặc mục đích quản lý của doanh nghiệp. Kết hợp tính năng thông báo tức thời kết quả giao dịch Tài khoản dịnh danh sẽ hỗ trợ doanh nghiệp quản lý công nợ/gạch nợ tự động và thống kê đối soát giao dịch thanh toán nhanh chóng.
Giải pháp Tài khoản định danh kiểm tra thông tin ghi có qua API mang lại cho doanh nghiệp các tiện ích:
- Các khoản thanh toán của doanh nghiệp được nhận diện nhanh chóng và chính xác.
- Doanh nghiệp phân loại và theo dõi các khoản thanh toán dễ dàng từ Tài khoản định danh.
- Doanh nghiệp có thể tạo nhiều tài khoản định danh để quản lý mục đích và đối tượng thanh toán thay vì phải mở nhiều tài khoản ngân hàng.
- Hệ thống API mở cho phép Doanh nghiệp tích hợp hệ thống đối soát gạch nợ nhanh chóng.
- Doanh nghiệp có tài khoản thanh toán tại ACB.
- Doanh nghiệp đăng ký Dịch vụ Tài khoản định danh ghi có theo Quy tắc khớp đúng đầu số và chính xác giá trị Tài khoản VA gọi qua API.
1. Kiểm tra Tài khoản VA qua API
1.1. Description
- Đây là chuẩn ACB cung cấp để doanh nghiệp xây dựng API theo chuẩn này với mục đích ACB gọi sang hệ thống hệ thống doanh nghiệp kiểm tra Tài khoản VA khi người thanh toán thực hiện chuyển tiền vào Tài khoản VA của doanh nghiệp.
- Điều kiện cần:
Đầu số Tài khoản VA đã được doanh nghiệp đăng ký tại ACB.
Giá trị Tài khoản VA được doanh nghiệp quản lý trên hệ thống của Doanh nghiệp.
1.2. Quy trình kiểm tra tài khoản VA
| #Bước | Mô tả | API |
| Bước 1: Nhập số Tài khoản VA để thực hiện chuyển tiền | Người chuyển tiền đăng nhập Ứng dụng ngân hàng và nhập Số Tài khoản VA để thực hiện chuyển tiền cho Doanh nghiệp. Ứng dụng Ngân hàng chuyển thực hiện gọi sang Ngân hàng ACB để kiểm tra Số tài khoản VA. ACB thực hiện tiếp Bước 2. | |
| Bước 2: Gửi số Tài khoản VA sang Hệ thống Doanh nghiệp để kiểm tra | Hệ thống ACB gọi đến hệ thống của Doanh nghiệp Số Tài khoản VA theo API kiểm tra Tài khoản VA để kiểm tra thông tin chính xác. Hệ thống Doanh nghiệp thực hiện Bước 3. | API kiểm tra Tài khoản VA |
| Bước 3: Nhận, kiểm tra Số Tài khoản VA và gửi trả thông tin đến hệ thống ACB | Doanh nghiệp tiếp nhận Số Tài khoản VA từ ACB và thực hiện: Kiểm tra Giá trị VA có tại và chính xác với thông tin tại hệ thống của Doanh nghiệp. Gửi trả thông tin cho ACB: Trường hợp 1: Gửi thông tin Tên thụ hưởng của Số Tài khoàn VA nhận từ ACB (Số Tài khoản VA tồn tại và chính xác với thông tin tại hệ thống Doanh nghiệp). Trường hợp 2: Gửi thông báo lỗi và mã lỗi (Số Tài khoản VA không tồn tại/không hoạt động/không chính xác tại hệ thống Doanh nghiệp). ACB thực hiện tiếp Bước 4. | |
| Bước 4: Nhận thông tin phản hồi từ Doanh nghiệp và chuyển thông tin đến ứng dụng Ngân hàng chuyển | Hệ thống ACB nhận thông tin từ Doanh nghiệp và thực hiện: 4.1. Nhận thông tin Tên thụ hưởng Tài khoản VA từ Doanh nghiệp: Phản hồi Tên thụ hưởng Tài khoản VA đến ứng dụng Ngân hàng chuyển. Người chuyển tiền thực hiện tiếp Bước 5. 4.2 Nhận thông báo lỗi từ Doanh nghiệp: Phản hồi thông báo lỗi đến ứng dụng Ngân hàng chuyển. Kết thúc quy trình. | |
| Bước 5: Người chuyển tiền hoàn tất việc chuyển tiền trên ứng dụng ngân hàng. | Người chuyển tiền kiểm tra thông tin thụ hưởng của Tài khoản VA được ACB phản hồi và thực hiện các công việc tiếp theo để hoàn tất việc chuyển tiền. Kết thúc Quy trình. ACB chuyển sang thực hiện thông báo ghi có Tài khoản VA qua API cho Doanh nghiệp. |
2. Thông báo thông tin giao dịch Tài khoản VA
2.1. Description
- Đây là chuẩn ACB cung cấp cho các doanh nghiệp để doanh nghiệp xây dựng API theo chuẩn này, ACB sẽ gọi API này để thông báo kết quả giao dịch ngay lập tức sau khi giao dịch Tài khoản VA được ghi có thành công.
2.2. Quy trình thông báo thông tin giao dịch Tài khoản VA
| #Bước | Mô tả | API |
| Bước 1: ACB nhận thanh toán Tài khoản VA | ACB nhận được thanh toán cho Tài khoản VA, tiến hành ghi có cho doanh nghiệp và thực hiện Bước 2. | |
| Bước 2: Gửi thông báo kết quả ghi có giao dịch Tài khoản VA đến doanh nghiệp | ACB chủ động gửi thông báo kết quả Tài khoản VA đã được ghi có đến hệ thống của doanh nghiệp. Hệ thống của doanh nghiệp thực hiện Bước 3. | API thông báo giao dịch Tài khoản VA |
| Bước 3: Hệ thống Doanh nghiệp tiếp nhận thông báo kết quả ghi có giao dịch Tài khoản VA và thực hiện xử lý các tác vụ nội bộ. | Hệ thống của doanh nghiệp tiếp nhận thông báo trạng thái giao dịch Tài khoản VA từ ACB và xử lý ca1`c tác vụ nội bộ thông qua API tự phát triển. Kết thúc Quy trình. | API tiếp nhận thông báo giao dịch Tài khoản VA và xử lý tác vụ nội bộ (tự phát triển). |
3. Thông báo danh sách giao dịch Tài khoản VA
3.1. Description
- Đây là chuẩn ACB cung cấp cho các doanh nghiệp để doanh nghiệp xây dựng API theo chuẩn này.
- ACB sẽ gọi API này để thông báo danh sách giao dịch ghi có Tài khoản VA thực hiện thành công ngày T-1.
3.2. Quy trình thông báo danh sách giao dịch Tài khoản VA
| #Bước | Mô tả | API |
| Bước 1: Trích xuất danh sách giao dịch Tài khoản VA của doanh nghiệp | Đầu mỗi ngày (làm việc) ACB trích xuất danh sách dữ liệu giao dịch Tài khoản VA ngày T-1 đã thực hiện ghi có thành công của doanh nghiệp và thực hiện Bước 2. | |
| Bước 2: Gửi thông tin đơn hàng cần thanh toán để tạo Tài khoản VA | ACB gửi danh sách giao dịch Tài khoản VA thanh toán thành công ngày T -1 cho doanh nghiệp: Trường hợp 1 : ngày T-1 doanh nghiệp có phát sinh giao dịch qua Tài khoản VA được ghi có trong ngày ACB sẽ gửi danh sách các giao dịch đã được ghi có. Trường hợp 2: ngày T-1 doanh nghiệp không phát sinh giao dịch Tài khoản VA được ghi có thành công ACB sẽ gửi tập rỗng. Sử dụng API tại Bước 3. | |
| Bước 3: Sử dụng API thông báo danh sách giao dịch Tài khoản VA | ACB gửi thông tin danh sách giao dịch Tài khoản VA đến doanh nghiệp thông qua API thông báo danh sách giao dịch Tài khoản VA. Hệ thống của nghiệp tiếp nhận thông báo trạng thái giao dịch từ ACB thông qua API tự phát triển để thực hiện tiếp tục Bước 4. | API thông báo danh sách giao dịch Tài khoản VA |
| Bước 4: Tiếp nhận danh sách giao dịch Tài khoản VA và xử lý nội bộ | Hệ thống của doanh nghiệp tiếp nhận danh sách giao dịch Tài khoản VA thực hiện thành công ngày T-1 ACB thông đã gửi qua API và xử lý nội bộ. Kết thúc quy trình. |
KỊCH BẢN KIỂM THỬ CÁC NGHIỆP VỤ TÀI KHOẢN VA KIỂM TRA QUA API
(Phục vụ cho việc kiểm thử sản phẩm trên hệ thống Sandbox của ACB)
Giải thích từ ngữ:
VAID: đầu số Tài khoản VA (3 ký tự đầu)
Giá trị Tài khoản VA là chuỗi giá trị ngay sau VAID
Thông tin đơn vị hưởng: Là thông tin tương ứng với Giá trị tài khoản VA trên hệ thống của Doanh nghiệp
Bộ tài liệu các API:
Kiểm tra thông tin thụ hưởng (dùng sử dụng để kiểm thử).
Kiểm tra Tài khoản VA qua API của doanh nghiệp (API doanh nghiệp phát triển).
Nạp tiền vào Tài khoản VA của khách hàng. (dùng sử dụng để kiểm thử).
Thông báo giao dịch ghi có/ghi nợ cho khách hàng ACB.
STT | Tính năng | Mô tả tình huống | Điều kiện | Kết quả mong đợi |
1 | Truy vấn thông tin thụ hưởng Tài khoản Định danh | Sử dụng API truy vấn thông tin tài khoản Truy vấn thông tin thụ hưởng nội bộ ACB
| Đúng số Tài khoản VA và độ dài Tên viết tắt doanh nghiệp + Tên thụ hưởng Tài khoản VA tại hệ thống doanh nghiệp ≤ 70 ký tự | Mã lỗi: 200-0000000 Success Hiển thị Tên thụ hưởng Tài khoản Định danh = Tên viết tắt + Tên nhận từ hệ thống doanh nghiệp |
2 | Truy vấn thông tin thụ hưởng Tài khoản Định danh | Sử dụng API truy vấn thông tin tài khoản Truy vấn thông tin thụ hưởng nội bộ ACB
| Đúng số Tài khoản VA và độ dài Tên viết tắt doanh nghiệp + Tên thụ hưởng Tài khoản VA tại hệ thống doanh nghiệp > 70 ký tự | Mã lỗi: 400-02020273 Success Thông báo lỗi và không hiển thị Tên thụ hưởng Tài khoản Định danh = Tên viết tắt + Tên nhận từ hệ thống doanh nghiệp |
3 | Truy vấn thông tin thụ hưởng Tài khoản Định danh | Sử dụng API truy vấn thông tin tài khoản Truy vấn thông tin thụ hưởng nội bộ ACB
| Đúng số Tài khoản VA và độ dài Tên viết tắt doanh nghiệp + Tên thụ hưởng Tài khoản VA tại hệ thống doanh nghiệp ≤ 70 ký tự và có chứa các ký tự đặc biệt (),.’-&_+ | Mã lỗi: 200-0000000 Success Hiển thị Tên thụ hưởng Tài khoản Định danh = Tên viết tắt + Tên nhận từ hệ thống doanh nghiệp |
4 | Truy vấn thông tin thụ hưởng Tài khoản Định danh | Sử dụng API truy vấn thông tin tài khoản Truy vấn thông tin thụ hưởng nội bộ ACB
| Đúng số Tài khoản Định danh và độ dài Tên viết tắt doanh nghiệp + Tên thụ hưởng Tài khoản VA tại hệ thống doanh nghiệp < 70 ký tự và chứ ký tự đặc biệt khác các ký tự (),.’-&_+ | Mã lỗi: 400-02020273
Thông báo lỗi và không hiển thị Tên thụ hưởng Tài khoản Định danh = Tên viết tắt + Tên nhận từ hệ thống doanh nghiệp |
5 | Truy vấn thông tin thụ hưởng Tài khoản Định danh | Sử dụng API truy vấn thông tin tài khoản Truy vấn thông tin thụ hưởng nội bộ ACB
| Số Tài khoản VA không chính xác hoặc không tồn tại trong hệ thống doanh nghiệp | Mã lỗi: 202-42020006 The account not found/Số tài khoản không tồn tại |
6 | Truy vấn thông tin thụ hưởng Tài khoản Định danh | Sử dụng API truy vấn thông tin tài khoản Truy vấn thông tin thụ hưởng nội bộ ACB
| Số Tài khoản VA tồn tại trong hệ thống doanh nghiệp nhưng ở trạng thái bị khóa/đóng. | Mã lỗi: 202-42020006 The account not found/Số tài khoản không tồn tại |
7 | | Tài khoản có phát sinh giao dịch nộp tiền/nhận tiền chuyển khoản trong giờ giao dịch | Khi thực hiện kiểm thử trên API ghi có Tài khoán VA thành công sẽ nhận được thông báo báo có tức thời | Giao dịch được ghi nhận vào log để gửi khách hàng đúng thông tin |
8 | Thông báo giao dịch ghi có | Tổng hợp giao dịch ghi có cuối ngày | Tài khoản có đăng ký nhận báo có cuối ngày
| Các giao dịch ghi có trong ngày được tổng hợp vào log để gửi khách hàng |