Thu tiền bằng số dư ví

Quy trình trừ số dư của khách để trả đơn tại quầy và trên website, gồm bước xác nhận bằng mã và cách xử lý khi số dư không đủ.

Thông tin chung

Trường	Nội dung
Mục đích	Trừ đúng số tiền, đúng ví, đúng một lần; và bảo đảm giao dịch lớn có bằng chứng chủ ví đồng ý
Đối tượng áp dụng	Thu ngân (tại quầy), Khách hàng tự thao tác (website), Chăm sóc khách hàng (xử lý khiếu nại)
Phạm vi	Đơn hàng trả bằng phương thức Ví khách hàng ở POS và website. KHÔNG áp dụng cho đơn bán gói nạp — xem Phát hành số dư từ đơn nạp
Tần suất	Khi phát sinh — mỗi đơn khách chọn trả bằng ví

Điều kiện tiên quyết

Đã bật thanh toán bằng ví khách hàng và đặt hai ngưỡng mã xác nhận — xem Cài đặt ví
Template ZNS có đủ hai tham số otp và amount
Chế độ mã cố định (gỡ lỗi ZNS) đã tắt trên môi trường thật
Khách có số điện thoại Zalo trong hồ sơ
Khách đã có số dư — xem Sổ số dư

Các bước thực hiện

Bước 1: Xác định chủ ví

Ai làm: Thu ngân (POS) hoặc hệ thống (website)
Thao tác: Tại quầy, chọn khách hàng đích danh vào giỏ — xem Khách hàng tại POS. Trên website, khách phải đăng nhập
Kết quả mong đợi: Phương thức Ví khách hàng mở khoá và hiện số dư hiện tại

Bước 2: Kiểm tra số dư có đủ toàn phần

Ai làm: Thu ngân hoặc khách hàng
Thao tác: Đọc số dư hiển thị ngay trên ô phương thức. Nếu không đủ, hệ thống ghi rõ “không đủ cho đơn này”
Kết quả mong đợi: Biết trước có đi tiếp được không, không mất công tạo đơn rồi mới phát hiện

Ví thanh toán toàn phần, không trả một phần rồi bù tiền mặt.

Bước 3: Tạo đơn và mở bảng kê ví

Ai làm: Thu ngân hoặc khách hàng
Thao tác: Tạo đơn như bình thường. Bảng kê hiện ba dòng: số dư hiện tại, số trừ cho đơn này, số dư còn lại — xem Thanh toán bằng ví tại POS và trên website
Kết quả mong đợi: Cả hai bên nhìn thấy chuyện gì sắp xảy ra trước khi đồng ý

Bước 4: Xác nhận bằng mã (nếu đạt ngưỡng)

Ai làm: Khách hàng đọc mã, Thu ngân nhập (tại quầy); khách tự nhập (website)
Thao tác: Đề nghị khách đối chiếu số tiền trong tin nhắn rồi mới đọc mã. Nhập mã trong thời hạn hiệu lực
Kết quả mong đợi: Có bằng chứng chủ ví đồng ý với đúng khoản tiền đó

Mã gửi tới số điện thoại của chủ ví, không phải số trên đơn. Với đơn giao cho người khác hoặc mua làm quà, hai số này khác nhau. Không đọc mã hộ khách, không nhập mã thay khách khi khách không có mặt — làm vậy là vô hiệu hoá toàn bộ mục đích của bước này.

Bước 5: Trừ ví và đóng đơn

Ai làm: Thu ngân hoặc khách hàng
Thao tác: Bấm xác nhận trừ ví
Kết quả mong đợi: Màn hình báo trừ thành công kèm số dư còn lại; đơn chuyển Đã thanh toán; sổ ví có một dòng loại Sử dụng với mã order_<mã đơn>

Xử lý ngoại lệ

Tình huống	Cách xử lý
Số dư không đủ	Không có cách trả một phần. Hoặc bán gói nạp trên đơn riêng rồi phát số dư và quay lại, hoặc đổi phương thức. Tuyệt đối không gộp gói nạp vào chính đơn đang mua
Khách không nhận được tin nhắn	Kiểm tra số điện thoại trong hồ sơ khách, bấm Gửi lại. Vẫn không được thì đổi phương thức thanh toán. Không bỏ qua bước xác nhận
Nhập sai mã nhiều lần	Hệ thống khoá sau số lần cho phép. Bấm gửi mã mới. Hết lượt gửi lại thì chờ hoặc đổi phương thức
Mã hết hạn giữa chừng	Gửi lại mã mới. Mã cũ mất hiệu lực ngay khi có mã mới
Trừ xong nhưng đơn vẫn hiện chưa thanh toán	Màn hình tự thử lại vài lần. Nếu vẫn vậy, mở lại đơn và bấm xác nhận lần nữa — hệ thống nhận ra tiền đã trừ và chỉ cập nhật đơn, không trừ lần hai
Khách nói bị trừ hai lần	Mở sổ ví, lọc theo mã khách. Mỗi đơn chỉ có một dòng `order_<mã đơn>`. Nếu thật sự có hai dòng cho cùng một đơn, báo kỹ thuật ngay — đây là lỗi nghiêm trọng
Cần hoàn tiền đơn đã trả bằng ví	Trả lại số dư bằng giao dịch điều chỉnh trên sổ ví, ghi chú mã đơn và lý do. Không hoàn bằng tiền mặt trừ khi có quyết định riêng — xem Xử lý sự cố số dư
Số dư khách thấy khác số hệ thống báo	Mở sổ ví của khách, đọc cột Số dư sau GD từ dòng cũ lên dòng mới. Chuỗi phải liền mạch
Màn hình hiện cảnh báo “Chế độ mã cố định”	Bước xác nhận đang không có tác dụng bảo vệ. Báo quản trị viên tắt chế độ gỡ lỗi ZNS trước khi tiếp tục thu tiền giá trị lớn

Checklist hoàn thành

Đơn ở trạng thái Đã thanh toán, phương thức ghi nhận là ví khách hàng
Sổ ví có đúng một dòng loại Sử dụng với mã order_<mã đơn>
Số dư còn lại hiển thị khớp giữa POS, website và sổ ví
Với giao dịch đạt ngưỡng: mã do chính khách đọc hoặc chính khách nhập

Tài liệu liên quan

SOP liên quan: Phát hành số dư từ đơn nạp, Xử lý sự cố số dư
Tính năng: Thanh toán bằng ví tại POS, Thanh toán bằng ví trên website, Cài đặt ví