API Vietcombank: Trọn bộ hướng dẫn tích hợp mới nhất
API Vietcombank là gì? Làm thế nào để kết nối Vietcombank với hệ thống phần mềm? Thông qua bài viết dưới đây, chúng tôi sẽ giúp doanh nghiệp hiểu rõ cách kết nối Vietcombank thông qua Banking API của Tingee, từ đó dễ dàng ứng dụng vào quá trình quản lý và tự động hóa giao dịch ngân hàng.

API Vietcombank là gì?
API Vietcombank có thể hiểu là phương thức kết nối giữa tài khoản Vietcombank và một hệ thống phần mềm thông qua API (giao diện lập trình ứng dụng), cho phép hệ thống thực hiện các nghiệp vụ ngân hàng được hỗ trợ mà không cần xử lý thủ công.
Trong hệ thống Tingee, Vietcombank là một trong các ngân hàng được hỗ trợ kết nối và tạo tài khoản ảo. Banking API của Tingee cung cấp các API để đối tác thực hiện quy trình từ tạo/liên kết tài khoản, xác nhận tài khoản, đăng ký nhận biến động đến truy vấn lịch sử giao dịch.
API Vietcombank của Tingee hỗ trợ những gì?
Banking API của Tingee cung cấp một hệ thống API xoay quanh việc quản lý tài khoản và giao dịch. Với API Vietcombank, các nghiệp vụ chính gồm:
API lấy danh sách ngân hàng/ví điện tử hỗ trợ
API này cho phép truy vấn danh sách các ngân hàng/ví điện tử hiện đang được Tingee hỗ trợ liên kết và tạo tài khoản ảo (VA).
API đồng bộ ví điện tử
API này được sử dụng để đồng bộ thông tin ví điện tử của khách hàng với hệ thống Tingee trước khi triển khai các dịch vụ liên kết tài khoản.
Sau khi gọi API thành công, hệ thống sẽ trả về đường dẫn redirectLink để khách hàng xác thực và cấp quyền cho Tingee.
API truy vấn danh sách tài khoản
API này dùng để truy vấn danh sách các tài khoản ảo (VA) đã được khởi tạo trên hệ thống Tingee, hỗ trợ phân trang và tìm kiếm theo nhiều tiêu chí.
API tạo tài khoản ảo (VA)
API này có chức năng tạo mới tài khoản ảo (VA) cho Merchant, cho phép nhận thông báo biến động số dư và quản lý dòng tiền tách biệt.
API xác nhận tài khoản ảo (VA)
API này dùng để xác nhận việc tạo tài khoản ảo (VA) sau khi hoàn tất bước khởi tạo. API thường được sử dụng trong trường hợp ngân hàng yêu cầu xác thực OTP để hoàn tất quá trình liên kết.
API đăng ký nhận biến động (VA Notify)
API này dùng để đăng ký thông báo biến động cho tài khoản ảo (VA), đặc biệt là đối với các ngân hàng yêu cầu bước đăng ký webhook riêng biệt như ACB. Sau khi đăng ký thành công, Tingee sẽ gửi callback mỗi khi có giao dịch phát sinh trên VA.

API xác nhận đăng ký nhận biến động (VA Notify)
API này dùng để xác nhận việc đăng ký nhận thông báo biến động số dư (VA Notify) sau khi đã khởi tạo yêu cầu qua API register-notify. Bước này thường yêu cầu mã OTP được gửi từ phía ngân hàng để hoàn tất quy trình.
API xóa tài khoản ảo (VA)
API này dùng để xóa tài khoản ảo (Virtual Account – VA) đã được tạo trước đó. Thường dùng khi Merchant muốn hủy các VA không còn sử dụng.
API xác nhận xóa tài khoản ảo (VA)
API này dùng để xác nhận việc xóa tài khoản ảo (Virtual Account – VA) sau khi đã gửi yêu cầu xóa. Thường được sử dụng khi ngân hàng yêu cầu xác thực OTP để hoàn tất quá trình hủy.
API lịch sử giao dịch
API dùng để truy vấn danh sách lịch sử giao dịch (ghi có và ghi nợ) của Merchant hoặc Shop. Bạn có thể lọc theo số tài khoản ảo (VA), mã ngân hàng, hoặc khoảng thời gian cụ thể để phục vụ việc đối soát.
Vietcombank hỗ trợ loại tài khoản nào trên Tingee?
Khả năng hỗ trợ của Vietcombank trên Tingee có sự khác biệt theo loại tài khoản và nghiệp vụ.
| Loại tài khoản | QR động | QR tĩnh |
| Cá nhân | Không | Có |
| Hộ kinh doanh | Có | Có |
| Doanh nghiệp | Có | Có |
Ngoài ra, với tài khoản hộ kinh doanh và doanh nghiệp, Vietcombank nằm trong nhóm ngân hàng yêu cầu cấu hình thông tin tài khoản trước khi thực hiện liên kết. Đối tác có thể chủ động thực hiện cấu hình thông qua API cấu hình tài khoản doanh nghiệp.
Quy trình tích hợp API Vietcombank với Tingee
Quy trình tích hợp API Vietcombank của Tingee được xây dựng theo các bước chính:
Khởi tạo Virtual Account
Sử dụng API create-va để tạo số tài khoản định danh riêng biệt cho người dùng.
Đăng ký nhận thông báo
Cấu hình Webhook để nhận data giao dịch tự động thông qua luồng register-notify.
Đối soát real-time
Kiểm tra lịch sử giao dịch định kỳ để đảm bảo tính nhất quán của dữ liệu tài chính.
Như vậy với Banking API của Tingee, doanh nghiệp có thể kết nối API Vietcombank với hệ thống phần mềm để hỗ trợ quản lý tài khoản và tự động hóa các giao dịch ngân hàng. Thông qua hệ thống API, doanh nghiệp có thể triển khai quy trình từ khởi tạo VA, đăng ký nhận thông báo biến động đến kiểm tra và đối soát lịch sử giao dịch, qua đó giảm bớt các thao tác xử lý thủ công.

Nếu doanh nghiệp đang tìm kiếm giải pháp kết nối Vietcombank với hệ thống, Tingee cung cấp hệ thống Banking API cùng tài liệu kỹ thuật chi tiết, giúp đội ngũ phát triển dễ dàng tìm hiểu và triển khai theo nhu cầu.
Để lại thông tin liên hệ TẠI ĐÂY để được tư vấn triển khai tích hợp ngay hôm nay.
