API ngân hàng là gì? Cách hoạt động và ứng dụng thực tế

Bởi Pay2S 4 phút đọc

Khi khách quét mã QR và chuyển khoản, làm sao website bán hàng biết đơn nào đã được thanh toán? Một cách là dùng API ngân hàng để nhận thông tin giao dịch, sau đó đối chiếu với dữ liệu đơn hàng. Đây cũng là cách phần mềm kế toán, ứng dụng tài chính và hệ thống quản lý bán hàng có thể làm việc với dữ liệu ngân hàng.

API ngân hàng là gì?

API ngân hàng là giao diện cho phép phần mềm gửi yêu cầu hoặc nhận dữ liệu từ hệ thống ngân hàng theo các quy tắc đã định. Tùy dịch vụ và quyền được cấp, ứng dụng có thể tra cứu lịch sử giao dịch, kiểm tra trạng thái thanh toán hoặc sử dụng các chức năng khác do ngân hàng cung cấp.

Ví dụ, phần mềm kế toán có thể lấy danh sách giao dịch ghi có trong ngày để đối chiếu với các khoản phải thu. Phần mềm gửi yêu cầu theo định dạng ngân hàng quy định và nhận kết quả dưới dạng dữ liệu có cấu trúc để xử lý tự động.

API ngân hàng hoạt động như thế nào?

Lấy ví dụ một phần mềm cần tra cứu giao dịch trên tài khoản đã kết nối. Quy trình thường gồm bốn bước.

  1. Gửi yêu cầu. Phần mềm gọi API với thông tin cần tra cứu, chẳng hạn mã tài khoản và khoảng thời gian.

  2. Xác thực và kiểm tra quyền. Hệ thống tiếp nhận kiểm tra ứng dụng gọi API có quyền truy cập tài khoản và sử dụng chức năng đó hay không.

  3. Trả kết quả. Nếu yêu cầu hợp lệ, API trả dữ liệu trong phạm vi được cấp quyền, chẳng hạn mã giao dịch, số tiền, thời gian và nội dung chuyển khoản.

  4. Xử lý dữ liệu. Phần mềm dùng kết quả để đối soát, cập nhật trạng thái đơn hàng hoặc hiển thị trên báo cáo.

Nếu hệ thống hỗ trợ webhook, thông tin giao dịch mới có thể được gửi chủ động đến phần mềm khi phát sinh sự kiện. Ví dụ, website nhận webhook khi có giao dịch ghi có và dùng API tra cứu lại lịch sử khi cần đối soát cuối ngày.

API ngân hàng được dùng vào việc gì?

Ứng dụng Ví dụ thực tế
Xác nhận thanh toán Website nhận thông tin chuyển khoản và đối chiếu với đơn hàng.
Đối soát giao dịch Phần mềm kế toán so sánh các khoản tiền nhận được với hóa đơn hoặc công nợ.
Thông báo biến động số dư Hệ thống gửi thông báo cho bộ phận bán hàng hoặc kế toán khi ghi nhận giao dịch mới.
Tích hợp dịch vụ tài chính Ứng dụng hiển thị thông tin tài khoản hoặc giao dịch trong phạm vi được cấp quyền.

Với doanh nghiệp, lợi ích dễ thấy nhất là giảm thao tác kiểm tra sao kê và cập nhật trạng thái thủ công. Nhà phát triển có thể đưa các chức năng được cấp quyền vào quy trình sẵn có của website, ứng dụng hoặc phần mềm nội bộ.

Ví dụ xác nhận thanh toán chuyển khoản trên website

API ngân hàng là gì? Cách hoạt động và ứng dụng thực tế

Một website bán hàng có thể dùng Pay2S để tạo mã QR chuyển khoản theo từng đơn. Mã QR điền sẵn thông tin thanh toán, chẳng hạn số tiền và nội dung chuyển khoản chứa mã đơn. Khi Pay2S ghi nhận giao dịch, hệ thống gửi dữ liệu về website qua webhook.

Website đối chiếu nội dung chuyển khoản và số tiền với đơn hàng trước khi cập nhật trạng thái thanh toán. Các giao dịch thiếu tiền, sai nội dung hoặc chưa ghép được với đơn có thể được chuyển sang danh sách cần kiểm tra. Khi cần đối soát, doanh nghiệp có thể truy vấn lịch sử giao dịch qua API.

Nếu doanh nghiệp muốn triển khai quy trình này cho website hoặc phần mềm bán hàng, có thể xem giải pháp API ngân hàng của Pay2S.

Bảo mật khi tích hợp API ngân hàng

Cơ chế xác thực và cấp quyền phụ thuộc vào từng ngân hàng hoặc nhà cung cấp. Khi tích hợp, doanh nghiệp nên lưu thông tin xác thực ở phía máy chủ, chỉ cấp quyền cần thiết và dùng HTTPS để truyền dữ liệu. Nếu nhận thông báo qua webhook, hệ thống nên xác minh chữ ký hoặc thông tin xác thực theo tài liệu tích hợp trước khi dùng dữ liệu để cập nhật đơn hàng.

Website cũng nên lưu mã giao dịch và kiểm tra giao dịch đã được xử lý chưa. Nếu cùng một thông báo được gửi lại, bước này giúp tránh ghi nhận thanh toán hai lần.

Kết luận

API ngân hàng giúp phần mềm sử dụng dữ liệu giao dịch trong các quy trình như xác nhận thanh toán, quản lý công nợ và đối soát. Với website bán hàng, một ứng dụng cụ thể là ghép giao dịch chuyển khoản với đúng đơn hàng để cập nhật trạng thái tự động.

Đọc thêm OpenAPI trong lĩnh vực tài chính ngân hàng là gì?

Chia sẻ bài viết