SePay Bank Hub là gì?

Giới thiệu

SePay Bank Hub là nền tảng kết nối ngân hàng tập trung, cho phép đối tác của SePay:

Liên kết và quản lý tài khoản ngân hàng
Theo dõi giao dịch theo thời gian thực
Nhận thông báo sự kiện qua webhook
Quản lý dữ liệu ngân hàng một cách an toàn và chuẩn hóa

Bank Hub cung cấp Hosted Link (WebView) kết hợp với RESTful API, giúp đối tác không cần xây dựng giao diện ngân hàng phức tạp nhưng vẫn đảm bảo trải nghiệm người dùng và tính bảo mật cao.

Đối tượng sử dụng SePay Bank Hub

SePay Bank Hub phù hợp cho các sản phẩm cần kết nối tài khoản ngân hàng để xác thực, đồng bộ giao dịch và quản lý dòng tiền:

Website bán hàng & Marketplace

Xác thực thanh toán, theo dõi giao dịch theo thời gian thực và tự động đối soát doanh thu.

Hệ thống quản lý dòng tiền doanh nghiệp

Tự động ghi nhận biến động số dư, đối soát thu – chi và tổng hợp báo cáo dòng tiền tập trung.

Nền tảng tài chính & kế toán

Kết nối nhiều tài khoản ngân hàng, đồng bộ dữ liệu và kiểm soát dòng tiền trên một nền tảng duy nhất.

Dịch vụ cần tích hợp API ngân hàng tự động

Tích hợp nhanh qua WebView, cung cấp webhook sự kiện và API để tự động hóa quy trình.

Luồng hoạt động

Diagram

Rendering diagram...

Các ngân hàng hỗ trợ

Bank Hub hiện tại hỗ trợ kết nối với các ngân hàng sau:

Ngân hàng	Loại tài khoản	Tính năng
VPBank	Cá nhân	Chia sẻ qua tài khoản chính Đồng bộ tiền vào
VPBank	Sắp ra mắt doanh nghiệp Sắp ra mắt hộ kinh doanh	—
TPBank	Cá nhân	Chia sẻ qua tài khoản chính Đồng bộ tiền vào, tiền ra Đồng bộ số dư
TPBank	Doanh nghiệp Hộ kinh doanh	Chia sẻ qua tài khoản chính Đồng bộ tiền vào, tiền ra Đồng bộ số dư
Vietinbank	Cá nhân	Chia sẻ qua tài khoản chính Đồng bộ tiền vào, tiền ra Đồng bộ số dư
Vietinbank	Sắp ra mắt doanh nghiệp Hộ kinh doanh	Chia sẻ qua tài khoản chính Đồng bộ tiền vào, tiền ra
ACB	Cá nhân	Chia sẻ qua tài khoản chính Đồng bộ tiền vào, tiền ra
ACB	Doanh nghiệp Hộ kinh doanh	Chia sẻ qua tài khoản chính Đồng bộ tiền vào, tiền ra
BIDV	Cá nhân Sắp ra mắt hộ kinh doanh	Chỉ nhận tiền vào từ VA Đồng bộ tiền vào
BIDV	Sắp ra mắt doanh nghiệp	—
MBBank	Cá nhân Hộ kinh doanh	Chia sẻ qua tài khoản chính Đồng bộ tiền vào, tiền ra
MBBank	Doanh nghiệp	Chia sẻ qua tài khoản chính Đồng bộ tiền vào, tiền ra
OCB	Cá nhân	Chỉ nhận tiền vào từ VA Đồng bộ tiền vào
OCB	Sắp ra mắt doanh nghiệp Sắp ra mắt hộ kinh doanh	—
KienLongBank	Cá nhân Hộ kinh doanh	Chỉ nhận tiền vào từ VA Đồng bộ tiền vào
KienLongBank	Doanh nghiệp	Chỉ nhận tiền vào từ VA Đồng bộ tiền vào
MSB	Cá nhân Hộ kinh doanh	Chỉ nhận tiền vào từ VA Đồng bộ tiền vào
MSB	Doanh nghiệp	Chỉ nhận tiền vào từ VA Đồng bộ tiền vào

Sắp ra mắt — Quản lý Virtual Account (VA): tạo mới, liệt kê và vô hiệu hoá VA qua API hoặc Dashboard. Tính năng đang phát triển, sẽ sớm có mặt trên Bank Hub.

Lưu ý đặc thù theo ngân hàng

VietinBank (cá nhân và hộ kinh doanh) — Tiền tố SEVQR bắt buộc trong nội dung chuyển khoản

Với tài khoản VietinBank đã liên kết qua Bank Hub, hệ thống tự động thêm tiền tố SEVQR vào đầu nội dung chuyển khoản khi tạo QR thanh toán. Người chuyển cần giữ nguyên tiền tố này — nếu bị xóa hoặc thay đổi, SePay không nhận diện được giao dịch và sẽ không gửi webhook.

OCB, MSB, KienLongBank, TPBank — "Hủy liên kết" chỉ vô hiệu hóa trong Bank Hub

Với 4 ngân hàng này, thao tác "Hủy liên kết" chỉ vô hiệu hóa tài khoản trong hệ thống Bank Hub; liên kết phía ngân hàng vẫn được giữ nguyên. Khi cần khôi phục, đối tác có thể liên hệ SePay để kích hoạt lại tài khoản thủ công mà không phải xác thực OTP lần nữa.

Lưu ý

Môi trường Live: Sử dụng cho production với tài khoản ngân hàng thật
Môi trường Sandbox: Sử dụng cho testing và development với tài khoản demo Xem các ngân hàng dùng trên Sandbox
Danh sách ngân hàng được cập nhật thường xuyên, vui lòng liên hệ SePay để biết thêm chi tiết

Tại sao chọn SePay Bank Hub?

Tích hợp nhanh chóng

Kết nối và liên kết tài khoản ngân hàng chỉ trong vài phút thông qua hosted link, không cần tự xây dựng giao diện.

Bảo mật theo chuẩn ngân hàng

Không yêu cầu cung cấp mật khẩu ngân hàng. Mọi thao tác được thực hiện qua web view với mã hóa end-to-end.

API & Webhook đầy đủ

Cung cấp bộ API RESTful và webhook để quản lý tài khoản, giao dịch và đồng bộ dữ liệu theo thời gian thực.

Giảm vận hành thủ công

Tự động nhận giao dịch, đồng bộ số dư và đối soát, giúp giảm sai sót và tiết kiệm thời gian vận hành.

Tiết kiệm chi phí phát triển

Không cần đội ngũ phát triển riêng cho từng ngân hàng. Một lần tích hợp, kết nối được nhiều ngân hàng.

Theo dõi giao dịch real-time

Nhận thông báo biến động số dư tức thì qua IPN webhook, cập nhật trạng thái giao dịch ngay lập tức vào hệ thống.

Dữ liệu chuẩn hóa

Tất cả dữ liệu từ các ngân hàng khác nhau được chuẩn hóa thành một định dạng thống nhất, dễ dàng xử lý và quản lý.

Trải nghiệm người dùng mượt mà

Giao diện liên kết ngân hàng được thiết kế tối ưu cho cả desktop và xử lý lỗi thân thiện.

Phương thức tích hợp Hosted Link

Hosted Link là gì?

Hosted Link là giao diện WebView được SePay xây dựng sẵn, cho phép người dùng cuối liên kết hoặc hủy liên kết tài khoản ngân hàng một cách an toàn. Đối tác không cần tự xây dựng UI ngân hàng phức tạp, chỉ cần nhúng hosted_link_url (được tạo từ API Link Token) vào ứng dụng thông qua iframe hoặc SDK JavaScript. Hosted Link đảm bảo trải nghiệm người dùng chuẩn hóa, bảo mật cao và tuân thủ quy trình xác thực của từng ngân hàng.

SePay Bank Hub hỗ trợ 2 phương thức tích hợp giao diện Hosted Link:

Iframe / WebView

Nhúng trực tiếp hosted link vào website hoặc mobile app thông qua iframe hoặc WebView.

SDK JavaScript

Tích hợp thông qua SDK để kiểm soát tốt hơn vòng đời phiên, sự kiện và callback.

Bước tiếp theo

Để bắt đầu tích hợp SePay Bank Hub, bạn có thể thực hiện theo thứ tự sau:

Bắt đầu nhanh - Hướng dẫn từng bước tích hợp Bank Hub vào ứng dụng của bạn
Thông tin Sandbox - Lấy thông tin tài khoản test để thử nghiệm
API Reference - Xem chi tiết các API có sẵn

Gợi ý

Nếu bạn mới bắt đầu, hãy sử dụng môi trường Sandbox để thử nghiệm trước khi chuyển sang Production.