Hướng dẫn từng bước
Tài khoản nhận tiền và SePay: mã VietQR và tự đối soát
Ảnh trong bài chụp từ tài khoản dùng thử của FLY.VN nên chưa có tài khoản nào.
Màn Cài đặt → Tài khoản nhận tiền quyết định khách chuyển tiền vào đâu và đơn nào tự chuyển sang Đã thanh toán.
Khi nào dùng
- Lần đầu thiết lập, muốn hiện mã VietQR trên đơn cho khách quét.
- Đổi ngân hàng hoặc đổi số tài khoản nhận tiền.
- Muốn đơn tự ghi nhận tiền khi khách chuyển khoản, khỏi ghi tay.
- Đổi hoặc xoay Webhook Secret bên SePay và cần cập nhật lại ở FLY.VN.
Các bước
Màn có hai thẻ: Tài khoản ngân hàng (mã VietQR) và Tự đối soát chuyển khoản (SePay). Hai thẻ mở cùng một biểu mẫu và một nút Lưu ghi cả hai, chỉ khác tiêu đề hộp.
Mở biểu mẫu
Chưa có tài khoản: bấm Thêm tài khoản ở thẻ Tài khoản ngân hàng, hoặc Kết nối ở dòng SePay. Đã có: bấm Sửa (thẻ ngân hàng) hoặc Cài đặt (dòng SePay).
Điền thông tin ngân hàng
Nhập Tên ngân hàng, Số tài khoản, Chủ tài khoản, Mã ngân hàng (mã BIN NAPAS hoặc mã ngắn, ví dụ 970436 hoặc VCB, dùng để tạo mã QR). Số tài khoản luôn phải gõ đầy đủ, ô hiện dòng Hiện tại: … — nhập lại để lưu.
Nhập khoá SePay
Ở ô Webhook Secret SePay, dán khoá lấy từ SePay. Lần đầu bắt buộc; từ lần sau để trống là giữ khoá cũ.
Lưu
Bấm Lưu. Nút bị khoá cho đến khi đủ các ô bắt buộc.
Dán địa chỉ callback vào SePay
Mở lại biểu mẫu, mục Webhook callback có một đường dẫn. Bấm Sao chép (chuyển thành Đã sao chép) rồi dán vào trang quản lý của SePay để nhận báo có tự động. Đường dẫn không đổi khi bạn đổi khoá. Nếu máy chủ chưa cấu hình địa chỉ gốc, màn chỉ hiện mã token và bạn tự ghép.
Sau khi lưu, dòng SePay hiện Đang hoạt động kèm Khoá xác thực đã lưu. Tài khoản ngân hàng hiện dạng "tên ngân hàng •••• 4 số cuối" với nhãn Mặc định.
Quyền, giới hạn và bảo mật
- Chỉ Chủ shop (và Quản trị viên cũ) cấu hình được. Người chỉ có quyền xem thấy dòng: Bạn chỉ có quyền xem — cần quyền quản trị để cấu hình tài khoản nhận tiền.
- Chỉ một tài khoản cho mỗi cơ sở.
- Webhook Secret tối đa 159 ký tự, được mã hoá trước khi lưu và không bao giờ hiển thị lại.
- Số tài khoản và tên ngân hàng lưu rõ vì phải hiện công khai trên mã QR; màn chỉ hiện 4 số cuối.
- Mỗi lần lưu ghi nhật ký tên trường đã đổi và số tài khoản dạng che, không ghi khoá.
- Cách hệ thống khớp tiền với đơn (mã đơn DH… trong nội dung chuyển khoản, khớp đúng một đơn) xem ở bài Thanh toán.
Lỗi thường gặp
| Thông báo | Nguyên nhân | Cách xử lý |
|---|---|---|
| Cần nhập Webhook Secret SePay khi cấu hình lần đầu. | Lần đầu mà để trống khoá | Dán Webhook Secret từ SePay |
| Số tài khoản bắt buộc. / Mã ngân hàng bắt buộc. / Tên chủ tài khoản bắt buộc. | Bỏ trống ô bắt buộc | Điền đủ, nhớ gõ lại số tài khoản khi sửa |
| Vui lòng nhập tên ngân hàng | Chạm vào ô Tên ngân hàng rồi để trống | Nhập tên ngân hàng |
| Webhook secret quá dài (tối đa 159 ký tự). | Dán thừa ký tự | Dán lại đúng khoá |
| Thông tin tài khoản nhận tiền không hợp lệ. | Dữ liệu bị từ chối khi lưu | Kiểm tra lại các ô và thử lại |
| Bạn không có quyền cấu hình tài khoản nhận tiền. | Vai trò không có quyền sửa cài đặt | Nhờ chủ shop |
| Đơn vẫn không tự chuyển Đã thanh toán dù đã lưu | Chưa dán callback bên SePay, sai secret, hoặc nội dung chuyển khoản không có mã đơn | Xem Khách chuyển khoản nhưng đơn chưa Đã thanh toán |
Xem thêm
Câu hỏi thường gặp
Vì sao mỗi lần lưu phải gõ lại đầy đủ số tài khoản?
Số tài khoản không bao giờ được điền sẵn, chỉ hiện dạng che với 4 số cuối, để tránh lộ. Bạn gõ lại đầy đủ mỗi lần lưu.
Có thể thêm nhiều tài khoản nhận tiền không?
Không. Mỗi cơ sở chỉ có một tài khoản nhận tiền, hiện với nhãn Mặc định. Khi đã có, nút Thêm tài khoản biến mất, bạn chỉ Sửa.
Để trống Webhook Secret khi lưu thì sao?
Lần đầu bắt buộc nhập. Từ lần sau, để trống là giữ nguyên khoá cũ, nhập giá trị mới là thay khoá.
Đổi Webhook Secret có đổi địa chỉ callback không?
Không. Địa chỉ callback đã dán bên SePay giữ nguyên khi bạn đổi khoá.
Đây là tiền vào FLY.VN đúng không?
Không. Đây là tiền khách trả cho cơ sở của bạn. Tiền gia hạn gói và nạp ví tin nhắn là màn khác và tài khoản khác.
Ai cấu hình được?
Chủ shop (và Quản trị viên cũ). Người chỉ có quyền xem thấy thông tin nhưng không có nút Sửa hay Kết nối.
Cập nhật 30/09/2026