Tủ Locker Thông Minh Tích Hợp Thanh Toán: Tiền Mặt, MoMo Và VNPay

Phương thức thanh toán theo độ phổ biến tại VN (2024-2025): (1) QR Code VietQR: Chuẩn chung kết nối 40+ ngân hàng Việt Nam. Người dùng quét 1 QR duy nhất bằng app ngân hàng của mình (Vietcombank, Techcombank, MBBank...). Không cần tích hợp từng ngân hàng riêng — 1 QR phục vụ tất cả ngân hàng. Chi phí: Phí giao dịch thấp (0.1-0.3%). Độ phủ: Gần như toàn dân có tài khoản ngân hàng đều dùng được. → ƯU TIÊN NHẤT cho locker; (2) MoMo: 31 triệu người dùng (2024). SDK API đầy đủ cho tích hợp. Phù hợp với người dùng ví điện tử không có tài khoản ngân hàng; (3) VNPay QR: Phổ biến ở siêu thị, chuỗi F&B. Cùng logic với MoMo nhưng khác SDK; (4) ZaloPay: Tích hợp với Zalo (90 triệu người dùng Zalo) — tiềm năng lớn; (5) Tiền mặt (coin/bill acceptor): Cần thiết ở vị trí ít smartphone như khu vực nông thôn, người cao tuổi, du khách nước ngoài. Phần cứng tốn kém và cần bảo trì (kẹt tiền). Nếu budget hạn chế, bỏ tiền mặt và chỉ làm QR — phủ được 80%+ người dùng với chi phí thấp hơn nhiều. Khuyến nghị cho locker phổ thông: VietQR + MoMo + ZaloPay. Locker cao cấp/du lịch: Thêm tiền mặt và thẻ từ/contactless.

Kiến trúc tích hợp thanh toán locker: Lớp phần cứng: (a) Bill/Coin acceptor (tiền mặt): Kết nối qua RS-232 hoặc USB với locker controller. Driver giao tiếp nhận sự kiện 'coin inserted', 'bill accepted'. Locker controller cập nhật tổng tiền nhận được, so sánh với số tiền cần trả. Khi đủ tiền → mở ô và trả lại tiền thừa (coin dispenser). (b) Card reader (thẻ ngân hàng/contactless): NFC/EMV reader kết nối với payment terminal (thường là PAX, Ingenico, VeriFone). Payment terminal giao tiếp với acquirer bank qua ISO 8583 protocol. Locker nhận callback 'payment approved/declined'. Lớp phần mềm (gateway API): QR Code: Locker hiển thị QR trên màn hình. Người dùng quét → thanh toán trong app. Gateway gọi webhook/callback đến locker server: POST /payment-callback {'status': 'success', 'amount': 120000, 'transaction_id': 'XXX'}. Locker server nhận callback → xác minh chữ ký số (signature) → mở ô. Timeout: Nếu sau 5 phút không nhận callback → QR hết hạn, locker hiển thị thông báo và refresh QR. Bảo mật quan trọng: Luôn verify signature từ payment provider — không tin tưởng callback chưa verify vì có thể bị giả mạo. Dùng HTTPS cho tất cả webhook. Idempotency: Nếu callback đến 2 lần (retry), không mở ô 2 lần.

Xử lý exception trong thanh toán locker: Tình huống 1 — Thanh toán thành công nhưng ô không mở: Nguyên nhân: Lỗi cơ khí, mất điện sau khi nhận callback, lỗi kết nối giữa server và locker hardware. Giải pháp: Hệ thống phải log 'payment_received' trước khi open_door. Nếu open_door fail sau khi payment success → trigger support alert ngay. Admin có thể remote unlock từ dashboard. Refund nếu không khắc phục được trong 15 phút. Tình huống 2 — Người dùng đã trả tiền nhưng nói không nhận được gì: Log giao dịch: Thời gian QR quét, thời gian callback, thời gian mở cửa, thời gian đóng cửa. Camera tại locker: Xác minh có người lấy hàng không. Hệ thống tốt cần proof of delivery để xử lý tranh chấp. Tình huống 3 — Refund (hoàn tiền): MoMo/VNPay/ZaloPay đều có Refund API: gọi POST /refund với transaction_id. Tiền mặt: Không refund tự động được (coin dispenser giới hạn). Chính sách: Thường không refund sau khi đã mở ô. Tình huống 4 — Mạng chậm hoặc mất sóng: QR đã quét nhưng callback chưa đến → polling thêm 30 giây. Nếu vẫn không có → yêu cầu thanh toán lại. Payment provider sẽ tự refund nếu chuyển tiền đi mà merchant chưa nhận. Audit trail: Mọi giao dịch → log đầy đủ với timestamp → cần thiết để xử lý khiếu nại và báo cáo thuế.