Logo
  • Support
  • Youtube
  • Facebook
  • Telegram
Logo
  • Giới thiệu
  • SePay là gì?
  • Gói dịch vụ
  • Gói theo điểm bán
  • SePay eShop
  • Hướng dẫn chung
  • Đăng ký SePay
  • Thêm tài khoản ngân hàng
  • Xem giao dịch
  • Người dùng & Phân quyền
  • Tài khoản phụ
  • Cấu hình TK ngân hàng
  • Cấu hình công ty
  • Gói dịch vụ
  • Hóa đơn & thanh toán
  • Cấu hình chung
  • Hợp đồng điện tử
  • Tổng quan hợp đồng điện tử
  • Xác nhận bằng OTP (Zalo/SMS)
  • Ký số (USB token)
  • Ký tay gửi bưu điện
  • Vay vốn
  • Tổng quan vay vốn
  • Vay tín chấp
  • Vay thấu chi VPBank
  • Chia sẻ biến động số dư
  • Tích hợp Telegram
  • Tích hợp Lark Messenger
  • Tích hợp Viber
  • Mobile App
  • Đọc số tiền giao dịch
  • Tích hợp Loa thanh toán
  • Tích hợp web
  • Tích hợp Shopify
  • Tích hợp Sapo
  • Tích hợp Haravan
  • Tích hợp GoHighLevel
  • Tích hợp WooCommerce
  • Tích hợp Google Sheets
  • Tích hợp HostBill
  • Lập trình & Tích hợp
  • Tích hợp WebHooks
  • Lập trình WebHooks
  • Giả lập giao dịch
  • Tạo & nhúng QR Code
  • OAuth2
  • SePay API
  • Giới thiệu API
  • Tạo API Token
  • API Giao dịch
  • API Tài khoản ngân hàng
  • API VA theo Đơn hàng

Hướng dẫn kết nối tài khoản Sacombank cá nhân & hộ kinh doanh vào SePay

Bài viết này sẽ hướng dẫn bạn kết nối tài khoản Ngân Hàng Sacombank vào SePay thông qua API.

SePay chính thức hợp tác mở API cùng Ngân hàng Sacombank. Chỉ vài phút liên kết qua SePay, quý khách đã có thể nhận và quản lý giao dịch ngay tức thì.

SePay không hỏi mật khẩu ngân hàng: bạn chỉ cần nhập thông tin tài khoản và mã OTP do ngân hàng gửi.

Sau đây là các bước kết nối API Ngân hàng Sacombank:

Bước 1: Truy cập my.sepay.vn -> Chọn menu Ngân hàng -> Chọn Kết nối thêm

Truy cập my.sepay.vn -> Chọn menu Ngân hàng -> Chọn Kết nối thêm
Truy cập my.sepay.vn -> Chọn menu Ngân hàng -> Chọn Kết nối thêm
Truy cập my.sepay.vn -> Chọn menu Ngân hàng -> Chọn Kết nối thêm
Truy cập my.sepay.vn -> Chọn menu Ngân hàng -> Chọn Kết nối thêm

Bước 2: Tại giao diện kết nối API ngân hàng, nhấn chọn ngân hàng Sacombank. Ở bước Chọn loại tài khoản, chọn Cá nhân (hoặc Hộ kinh doanh) rồi nhấn Tiếp theo.

Chọn kết nối tại ngân hàng Sacombank
Chọn kết nối tại ngân hàng Sacombank

Bước 3: Xem các tính năng hỗ trợ và nhấn Tiếp theo. Ở câu hỏi Bạn đã có tài khoản chưa?, chọn Đã có tài khoản rồi nhấn Kết nối ngay.

Chọn kết nối tại ngân hàng Sacombank
Chọn kết nối tại ngân hàng Sacombank
Chọn kết nối tại ngân hàng Sacombank
Chọn kết nối tại ngân hàng Sacombank
Lưu ý: Tài khoản cá nhân và tài khoản hộ kinh doanh đều sử dụng số CCCD/CMND để xác thực.

Bước 4: Nhập các thông tin cần thiết:

  • Số tài khoản ngân hàng Sacombank
  • Tên chủ tài khoản
  • Số CCCD/CMND đã đăng ký cho số tài khoản trên
  • Số điện thoại đã dùng để đăng ký tài khoản ngân hàng
  • Tên gợi nhớ (không bắt buộc)

Đánh dấu ô Tôi đã đọc và đồng ý với điều kiện & điều khoản sử dụng dịch vụ chia sẻ biến động số dư của ngân hàng SACOMBANK (bắt buộc), sau đó nhấn nút Tiếp theo, hệ thống sẽ tự động gửi yêu cầu kết nối API đến Ngân hàng Sacombank.

Nhập thông tin tài khoản Sacombank
Nhập thông tin tài khoản Sacombank

Bước 5: Ngân hàng Sacombank sẽ gửi mã OTP xác thực về số điện thoại đã đăng ký. Bạn vui lòng nhập mã OTP và nhấn vào nút Liên kết API.

Nhập mã OTP và liên kết API
Nhập mã OTP và liên kết API
Trong trường hợp không nhận được mã OTP hoặc mã hết hiệu lực, vui lòng nhấn vào nút Gửi lại mã.

Bước 6: Sau khi liên kết API thành công, tại màn hình Cấu hình chung, bật hoặc tắt Đồng bộ giao dịch tiền vào và Đồng bộ giao dịch tiền ra theo nhu cầu. Bạn có thể đổi lại sau trong Chi tiết tài khoản.

Cấu hình đồng bộ giao dịch tiền vào / tiền ra
Cấu hình đồng bộ giao dịch tiền vào / tiền ra

Bước 7: Thực hiện thử một giao dịch chuyển tiền tới số tài khoản Sacombank vừa liên kết để kiểm tra kết nối.

Nếu nhận được thông báo giao dịch mới trên trang quản lý thì việc liên kết API tài khoản Sacombank của bạn đã hoàn tất.

Kiểm tra giao dịch mới
Kiểm tra giao dịch mới

Quản lý tài khoản ảo (VA)

Lưu ý:

Khi kết nối ngân hàng Sacombank cá nhân thông qua API, SePay nhận các giao dịch tiền vào và tiền ra tại số tài khoản chính từ ngân hàng Sacombank cung cấp (theo cấu hình Đồng bộ giao dịch tiền vào / tiền ra của tài khoản).

Bạn có thể tạo thêm tài khoản ảo (VA) để tách riêng các khoản thu. Tiền chuyển vào VA vẫn về tài khoản chính. Có 2 loại VA:

  • VA tĩnh: số VA cố định, dùng lâu dài. Ví dụ: mỗi cửa hàng hoặc mỗi kênh bán dùng một VA riêng.
  • VA động (tiền tố VA đơn hàng): dùng khi bạn bán hàng có tích hợp API. Bạn tạo tiền tố trước. Mỗi lần hệ thống của bạn tạo đơn hàng qua API (kèm tiền tố và số tiền), SePay cấp cho đơn đó một số VA riêng, gồm tiền tố và một dãy ký tự do SePay sinh ngẫu nhiên (không phải mã đơn hàng của bạn). Số VA này có thời hạn, mặc định 1 ngày.

Tạo VA tĩnh

Bước 1: Trong trang quản lý tài khoản Sacombank, mở tab VA tĩnh rồi nhấn + Thêm VA.

Chọn tab VA tĩnh và nhấn + Thêm VA
Chọn tab VA tĩnh và nhấn + Thêm VA

Bước 2: Ô Số VA đã có sẵn phần đầu cố định do SePay cấp. Bạn chỉ nhập phần còn lại, ví dụ STORE01: chữ in hoa không dấu hoặc chữ số, số ký tự tối đa ghi ngay dưới ô. Nếu không muốn tự đặt, nhấn nút tạo mã tự động ở cuối ô. Nhập thêm Tên gợi nhớ nếu cần, rồi nhấn Tiếp theo.

Nhập Số VA và tên gợi nhớ cho VA tĩnh
Nhập Số VA và tên gợi nhớ cho VA tĩnh

Bước 3: Lấy mã OTP từ tin nhắn SMS hoặc ứng dụng Sacombank Smart OTP (tùy phương thức xác thực bạn đăng ký với Sacombank), nhập vào ô Mã OTP rồi nhấn Xác nhận.

Nhập OTP để xác nhận tạo VA tĩnh
Nhập OTP để xác nhận tạo VA tĩnh

Bước 4: VA mới hiện trong danh sách với trạng thái Hoạt động. Đưa số VA đầy đủ ở cột Số VA (gồm cả phần đầu cố định) cho người chuyển tiền. Người chuyển nhập số này vào ô số tài khoản nhận như một số tài khoản bình thường.

VA tĩnh đã tạo thành công
VA tĩnh đã tạo thành công

Tạo tiền tố cho VA động

Bước 1: Trong trang quản lý tài khoản Sacombank, mở tab Tiền tố VA đơn hàng rồi nhấn + Tạo tiền tố.

Chọn tab Tiền tố VA đơn hàng và nhấn + Tạo tiền tố
Chọn tab Tiền tố VA đơn hàng và nhấn + Tạo tiền tố

Bước 2: Ô Tiền tố VA đã có sẵn phần đầu cố định do SePay cấp. Bạn chỉ nhập phần còn lại, ví dụ SHOP1: chữ in hoa không dấu hoặc chữ số, số ký tự tối đa ghi ngay dưới ô. Khung Cấu trúc VA đơn hàng cho xem trước số VA của mỗi đơn: tiền tố ở trước, phần Đơn hàng ở sau là dãy ký tự SePay tự sinh khi bạn tạo đơn. Nhấn Tiếp theo.

Nhập tiền tố cho VA động
Nhập tiền tố cho VA động

Bước 3: Lấy mã OTP từ tin nhắn SMS hoặc ứng dụng Sacombank Smart OTP (tùy phương thức xác thực bạn đăng ký với Sacombank), nhập vào ô Mã OTP rồi nhấn Xác nhận.

Nhập OTP để xác nhận tạo tiền tố VA động
Nhập OTP để xác nhận tạo tiền tố VA động

Bước 4: Tiền tố mới hiện trong danh sách với trạng thái Hoạt động. Khi gọi API tạo đơn hàng, truyền tiền tố đầy đủ như trong danh sách (gồm cả phần đầu cố định). Bạn có thể tạo nhiều tiền tố, ví dụ mỗi cửa hàng một tiền tố.

Tiền tố VA động đã tạo thành công
Tiền tố VA động đã tạo thành công
Tài liệu tích hợp API VA theo đơn hàng

Xem phần Bắt đầu nhanh để tạo đơn hàng qua API, nhận số VA cho từng đơn, cách đặt thời hạn VA và cách SePay khớp số tiền.

Chuyển đổi phương thức kết nối

Hiện tại với ngân hàng Sacombank, SePay hỗ trợ chuyển đổi linh hoạt phương thức kết nối giữa API Banking và SMS Banking cho các trường hợp:

  • Bạn đang sử dụng tài khoản Sacombank với phương thức kết nối SMS Banking trước đó và muốn chuyển sang phương thức API Banking để tăng chất lượng dịch vụ.
  • Trong trường hợp hệ thống ngân hàng Sacombank gián đoạn hoặc bảo trì, bạn muốn chuyển sang phương thức kết nối SMS Banking để không ảnh hưởng đến việc nhận thông báo biến động số dư của tài khoản.

1Chuyển phương thức kết nối từ SMS Banking -> API Banking

Bước 1: Chọn tài khoản ngân hàng Sacombank bạn muốn chuyển đổi

Bước 2: Tại trang quản lý tài khoản ngân hàng Sacombank, nhấp vào nút Chuyển sang phương thức kết nối API Banking

Bước 3: Điền các thông tin còn thiếu để thực hiện liên kết API:

  • Số CCCD/CMND (đối với tài khoản cá nhân và hộ kinh doanh) hoặc mã số thuế (đối với tài khoản doanh nghiệp)
  • Số điện thoại đã đăng ký với ngân hàng

Các bước khác thực hiện tương tự như việc thêm tài khoản ngân hàng Sacombank với hình thức liên kết API. Khi chuyển sang kết nối API, bạn cần xác thực OTP do ngân hàng gửi.

Sau khi chuyển đổi sang phương thức kết nối API Banking thành công, vui lòng thử thực hiện một giao dịch báo có/báo nợ để kiểm tra.

2Chuyển phương thức kết nối từ API Banking -> SMS Banking

Điều kiện để chuyển sang phương thức kết nối SMS Banking bắt buộc gói dịch vụ bạn đang sử dụng phải hỗ trợ SMS Banking. Xem thêm thông tin tại Bảng giá.

Bước 1: Chọn tài khoản ngân hàng Sacombank bạn muốn chuyển đổi

Bước 2: Tại trang quản lý tài khoản ngân hàng Sacombank, nhấp vào nút Chuyển sang phương thức kết nối SMS Banking

Bước 3: Tại hộp thoại xác nhận, vui lòng chọn SIM bạn muốn kết nối với tài khoản, sau đó nhấn vào nút Chuyển đổi

Lưu ý:

Nếu SIM chưa được đăng ký nhận thông báo biến động số dư thông qua SMS tại ngân hàng Sacombank trước đó, vui lòng tiến hành đăng ký số điện thoại đã chọn tại Bước 3 với ngân hàng Sacombank để nhận SMS biến động số dư cho tài khoản.

Trường hợp đã đăng ký số điện thoại nhận SMS biến động số dư trước đó, vui lòng thực hiện một giao dịch báo có/báo nợ bất kỳ để kiểm tra.

Ngoài ra, tại my.sepay.vn, bạn có thể:

  • Xem danh sách giao dịch
  • Xem danh sách ngân hàng đã kết nối hoặc tạo thêm VA.

Chúc bạn thành công!

Đọc tiếp: Xem giao dịch

Facebook Messenger

Hỗ trợ live chat 24/7

Hotline

Điện thoại hỗ trợ

Youtube

Theo dõi video mới nhất của SePay

Telegram

Nhận thông tin mới nhất từ SePay
Liên hệ chúng tôi