Hướng dẫn từng bước
Khách đã chuyển khoản nhưng đơn chưa chuyển sang Đã thanh toán
FLY.VN tự ghi nhận tiền cho đơn khi khách chuyển khoản, nhờ kết nối SePay: ngân hàng báo có cho SePay, SePay chuyển thông báo sang FLY.VN, hệ thống đọc mã đơn trong nội dung chuyển khoản rồi ghi khoản thu vào đúng đơn. Bài này giúp bạn tìm ra mắt xích nào đang đứt khi đơn không tự đổi trạng thái.
Khi nào dùng
- Khách báo đã chuyển khoản nhưng đơn vẫn Chưa thanh toán.
- Khách chuyển rồi nhưng đơn chỉ hiện Một phần hoặc Thừa tiền.
- Ô Giao dịch chờ duyệt tay ở màn Thanh toán có số lớn hơn 0.
Cách kiểm tra
Kiểm tra tài khoản nhận tiền
Vào Cài đặt → Tài khoản nhận tiền. Thẻ Tài khoản ngân hàng phải có một tài khoản (nhãn Mặc định). Nếu ghi Chưa có tài khoản nhận tiền, bấm Thêm tài khoản.
Kiểm tra SePay
Ở thẻ Tự đối soát chuyển khoản, dòng SePay phải hiện Đang hoạt động. Nếu hiện Chưa kết nối, bấm Kết nối rồi điền Webhook Secret SePay, Tên ngân hàng, Số tài khoản, Chủ tài khoản, Mã ngân hàng và bấm Lưu.
Dán đường dẫn webhook vào SePay
Bấm Cài đặt ở dòng SePay, mục Webhook callback có một đường dẫn. Bấm Sao chép và dán vào trang quản lý của SePay. Thiếu bước này thì SePay không gửi báo có sang FLY.VN. Webhook Secret ở SePay và ở FLY.VN phải giống nhau, sai secret thì thông báo bị từ chối.
Kiểm tra nội dung chuyển khoản
Nội dung chuyển khoản phải chứa mã đơn, ví dụ DH-202609-0049. Viết liền, có dấu gạch hay chữ thường đều được. Cách chắc nhất là gửi khách mã QR: khi tạo đơn nhanh trong Hộp thư với thanh toán VietQR, bấm Mã VietQR để lấy QR đã điền sẵn số tiền và nội dung, hoặc bấm Sao chép nội dung CK.
Kiểm tra trạng thái đơn
Chỉ đơn Chờ xác nhận hoặc Đã xác nhận và chưa Đã thanh toán mới tự khớp. Đơn đã sang Đang xử lý, Đang giao, Đã giao, đã hủy, hoặc đã thu đủ thì khoản chuyển khoản không tự ghi vào.
Kiểm tra số tiền
Hệ thống ghi đúng số tiền thật khách chuyển. Chuyển thiếu thì đơn thành Một phần, chuyển dư thì Thừa tiền. Đơn chỉ thành Đã thanh toán khi tổng đã thu bằng tổng đơn.
Khi tiền không tự khớp: ghi tay
Mở đơn, bấm Ghi nhận thanh toán, chọn Hình thức Chuyển khoản, nhập Số tiền thu rồi bấm Ghi nhận. Trong lúc chưa kết nối SePay, theo dõi các khoản chưa thu ở tab Công nợ của màn Thanh toán, xem bài Thu nợ khách hàng.
Trường hợp đặc biệt
- Giao dịch chờ duyệt tay: khoản báo có không có mã đơn, mã không khớp đơn nào, hoặc khớp nhiều đơn sẽ không được ghi, chỉ được đếm ở ô Giao dịch chờ duyệt tay (màn Thanh toán). Hiện chưa có màn để gán các giao dịch này vào đơn; bạn ghi tay trên đơn như trên.
- Tránh ghi hai lần: nếu đã ghi tay đủ tiền cho đơn, khoản chuyển khoản đến sau sẽ không tự ghi thêm vì đơn đã thu đủ.
- Đơn Chờ xác nhận được tự xác nhận: khi tiền vào đơn Chờ xác nhận, hệ thống xác nhận đơn trước rồi mới ghi tiền, nên kho và công nợ thay đổi cùng lúc.
- Chỉ tiền vào mới được xét: giao dịch chuyển tiền ra khỏi tài khoản bị bỏ qua.
- Quyền: kết nối SePay và sửa tài khoản nhận tiền cần quyền quản trị (Chủ shop, Quản trị viên). Vai trò khác 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.
Lỗi thường gặp
| Dấu hiệu / thông báo | Nguyên nhân | Cách xử lý |
|---|---|---|
| Dòng SePay Chưa kết nối | Chưa lưu kết nối | Bấm Kết nối, điền đủ các ô, Lưu |
| Đang hoạt động nhưng không đơn nào tự ghi tiền | Chưa dán Webhook callback vào SePay, hoặc Webhook Secret hai bên khác nhau | Sao chép lại đường dẫn, kiểm tra secret |
| Đơn vẫn Chưa thanh toán, ô Giao dịch chờ duyệt tay tăng | Nội dung CK thiếu hoặc sai mã đơn, hoặc đơn không ở trạng thái tự khớp | Ghi tay bằng Ghi nhận thanh toán |
| Đơn Một phần hoặc Thừa tiền | Khách chuyển khác tổng đơn | Thu thêm phần thiếu, hoặc xử lý phần dư với khách |
| Cần cấu hình tài khoản ngân hàng nhận tiền (SePay) trước khi tạo mã VietQR. … | Chưa có tài khoản nhận tiền | Làm bước 1 và 2 |
| Vui lòng nhập tên ngân hàng | Bỏ trống Tên ngân hàng | Điền tên ngân hàng |
Xem thêm
Câu hỏi thường gặp
Đơn tự chuyển sang Đã thanh toán khi nào?
Khi SePay đã kết nối ở Tài khoản nhận tiền, nội dung chuyển khoản có mã đơn, đơn đang Chờ xác nhận hoặc Đã xác nhận, và số tiền khách chuyển đủ tổng đơn.
Khách chuyển thiếu hoặc dư thì sao?
Hệ thống vẫn ghi đúng số tiền thật nhận được. Đơn thành Một phần nếu thiếu, Thừa tiền nếu dư, không bỏ qua khoản chuyển.
Khách ghi sai hoặc quên mã đơn trong nội dung chuyển khoản thì sao?
Hệ thống không tìm được đơn nên không tự ghi. Giao dịch được đếm ở ô Giao dịch chờ duyệt tay trong Thanh toán. Bạn ghi nhận tiền tay trên đơn bằng nút Ghi nhận thanh toán.
Ai được kết nối SePay?
Chủ shop và Quản trị viên. Vai trò khác chỉ xem được trạng thái.
Cập nhật 30/09/2026