Zalo Mini App cho quán ăn, F&B: tính năng nào nên làm trước
Tất cả blog / Hướng dẫn / Zalo Mini App cho quán ăn, F&B: tính năng nào nên làm trước
Lộc Nguyễn16 thg 11, 20268 phút đọc
Với quán ăn, tôi xếp thứ tự làm Zalo Mini App như sau: thực đơn và đặt món trước, mã QR tại bàn thứ hai, tích điểm thành viên thứ ba, đặt bàn thứ tư, giao hàng sau cùng. Lý do là mỗi bước dùng lại phần đã làm ở bước trước và rủi ro duyệt tăng dần.
Thứ tự trên là đánh giá của tôi, không phải quy định của Zalo. Phần kỹ thuật và chính sách tôi dẫn từ tài liệu Zalo Mini App mở ngày 09/11/2026, chỗ nào là ý kiến cá nhân tôi ghi rõ. Bài đi theo thứ tự: điều kiện hồ sơ riêng của ngành F&B, năm nhóm tính năng theo thứ tự làm, chỗ nào cần tích hợp máy POS, khoản mục chi phí, điểm bất lợi, câu hỏi thường gặp. Tôi không ghi giá làm hay thời gian làm vì mỗi quán mỗi khác và tài liệu không công bố.
Quán ăn cần gì về hồ sơ trước khi viết dòng mã đầu tiên
Trong danh sách ngành có điều kiện ở trang xác thực Mini App, F&B (kinh doanh hoặc quản lý dịch vụ ăn uống) yêu cầu giấy xác nhận ngành nghề kinh doanh phù hợp và giấy chứng nhận cơ sở đủ điều kiện an toàn thực phẩm. Quán bán rượu, bia hay đồ uống có cồn còn rơi vào nhóm hàng hạn chế kinh doanh của nền tảng, và danh mục xác thực có yêu cầu giấy phép riêng cho rượu. Nếu quán chưa có giấy tờ nào trong số này, hãy lo trước; việc viết ứng dụng không bù được.
Ngoài ra Mini App nào cũng phải xác thực chủ sở hữu, bằng OA doanh nghiệp đã xác thực hoặc bằng giấy tờ đăng ký kinh doanh. Chi tiết nằm trong bài quy trình duyệt Zalo Mini App.
Thứ tự tính năng nên làm
Tôi chia thành năm nhóm. Mỗi nhóm chỉ thêm một mảng việc mới, nên quán có thể ra mắt từng đợt và đo xem khách có dùng không trước khi làm tiếp.
Gọi món tại bàn: mã QR trên bàn, điện thoại quét mở mini app đặt món, bếp nhận đơn.
1. Thực đơn và đặt món
Đây là xương sống: danh mục món, ảnh, mô tả, tuỳ chọn (ít đường, thêm topping), giỏ hàng, xác nhận đơn. Quán nhỏ có thể khởi đầu bằng thực đơn có giá và thanh toán tại quầy. Nhưng cần lưu ý chính sách kiểm duyệt: Mini App có phát sinh đơn hàng, có chức năng thanh toán và hiển thị giá trực tiếp thì cần Checkout SDK; chưa dùng thì phải bỏ giá và đổi nút mua sang «Liên hệ» hoặc «Tư vấn». Trường hợp thực đơn có giá nhưng thanh toán tại quầy rơi ở vùng xám, tôi khuyên hỏi lại bộ phận hỗ trợ trước khi làm. Thanh toán qua mini app xem bài thanh toán trong Zalo Mini App.
Về kỹ thuật, tài liệu ghi mini app không hỗ trợ LocalStorage, SessionStorage và Cookie. Giỏ hàng nên lưu ở máy chủ hoặc dùng Native Storage; nhóm API Native Storage cần xin quyền từ Zalo.
2. Mã QR tại bàn
Tài liệu nêu cách mở Mini App qua mã QR của ứng dụng, hoặc qua liên kết dạng https://zalo.me/s/{appId}/?variable=value với appId là Mini App ID. Hàm getRouteParams đọc các tham số gửi đến trang hiện tại. Đây là cơ sở để mỗi bàn có một mã riêng gắn tham số số bàn. Cách gắn số bàn vào tham số là thiết kế của tôi, tài liệu không có ví dụ riêng cho quán ăn. Khách quét mã bằng camera điện thoại hoặc QR Scanner của Zalo là vào thẳng thực đơn của đúng bàn.
3. Tích điểm và thành viên
Số điện thoại là khoá nhận diện khách quen. Tôi khuyên xin số vào lúc khách bấm đăng ký thẻ thành viên, đúng như tài liệu hướng dẫn xin quyền; cách làm kỹ thuật nằm trong bài lấy số điện thoại trong Zalo Mini App. Hai điểm cần soát: chính sách kiểm duyệt liệt kê tính năng liên quan đến rút tiền hoặc trả thưởng vào nhóm vi phạm, nên cách thiết kế điểm thưởng (đổi món, giảm giá, không đổi ra tiền) phải được mô tả rõ; và đừng bắt khách cấp quyền mới dùng được thực đơn.
4. Đặt bàn
Một form chọn giờ, số người, ghi chú, gửi về máy chủ của quán và báo lại cho nhân viên. Nếu chưa muốn làm form, tài liệu có sẵn hàm openPhone mở ứng dụng gọi điện và openChat mở cửa sổ nhắn tin với người dùng hoặc Official Account. Đây là cách rẻ để ra mắt tính năng đặt bàn sớm.
5. Giao hàng
Đây là nhóm nặng nhất: địa chỉ, phí ship, trạng thái đơn, thông báo. Hàm getLocation lấy vị trí người dùng, thuộc nhóm quyền cần cho phép từ cả Zalo và người dùng. Nếu quán tự giao, bắt đầu bằng COD và chuyển khoản, hai phương thức có sẵn trong Checkout SDK, rồi mới thêm ví điện tử. Muốn nhắn khách khi đơn có thay đổi, tài liệu hướng dẫn gửi thông báo qua OA hoặc ZBS; điều kiện và giá của kênh này anh chị xem trên trang chính thức của Zalo.
Cái gì cần tích hợp máy POS, cái gì để sau
Tài liệu Zalo Mini App không nói gì về máy POS cụ thể, nên phần này hoàn toàn là kinh nghiệm cá nhân của tôi:
Tính năng
Cần nối POS ngay?
Lý do
Thực đơn
Nên có, nhưng chưa bắt buộc
Giá và món hết có thể sửa tay lúc đầu; nối POS để khỏi nhập hai nơi
Đặt món, QR tại bàn
Có, nếu muốn đơn đổ thẳng ra bếp
Không nối thì nhân viên phải nhập lại đơn, dễ sai
Tích điểm
Chưa cần
Có thể tính điểm theo đơn trên mini app trước
Đặt bàn
Không
Chỉ cần báo cho nhân viên
Giao hàng
Có, nếu bếp đã dùng POS
Đơn giao cũng phải vào cùng luồng bếp
Việc nối được hay không phụ thuộc phần mềm POS của quán có cổng kết nối hay không. Anh chị hỏi nhà cung cấp trước khi chốt phạm vi; đội tôi cũng nhận khảo sát giúp, xem trang liên hệ làm mini app.
Các khoản mục chi phí
Tôi chỉ liệt kê khoản mục, không ghi số. Theo kinh nghiệm của tôi và các điều kiện trong tài liệu:
Thiết kế và viết mã mini app, gồm cả máy chủ nhận đơn.
Máy chủ, tên miền và chứng chỉ SSL. Chính sách yêu cầu kết nối API dùng https với chứng chỉ hợp lệ.
Hồ sơ xác thực và giấy phép an toàn thực phẩm.
Phí cổng thanh toán nếu nhận tiền qua ví hoặc thẻ, tính theo hợp đồng từng cổng.
Tin nhắn OA hoặc ZBS nếu nhắn khách, theo bảng giá của Zalo.
Tích hợp POS, tuỳ nhà cung cấp.
Vận hành sau ra mắt: sửa thực đơn, xử lý lỗi, và gửi phiên bản mới qua duyệt.
Điểm bất lợi và rủi ro với quán ăn
Giá trị phụ thuộc thói quen khách. Tôi không có số liệu công khai về tỷ lệ khách chịu đặt món qua mini app, nên không hứa con số nào. Hãy đo bằng đợt thử ở vài bàn.
Giao diện bị ràng buộc. Mỗi màn hình tối đa một hành động chính, thanh điều hướng dưới tối đa 4 tab, vùng chạm tối thiểu 44 x 44 pt. Thực đơn nhiều món phải thiết kế gọn.
Quán không ai trực mini app sẽ hỏng. Đơn đến mà không ai nhận thì khách bỏ. Cần quy trình ai xem đơn, ai báo hết món.
Duy trì lượt dùng. Chính sách yêu cầu tối thiểu 10 lượt truy cập mỗi tháng; chưa đạt trong 3 tháng có thể bị hạn chế hiển thị.
Tên Mini App không được chứa chữ «Zalo» hoặc «App» và nên có tên đơn vị sở hữu; đặt tên sớm để khỏi bị sửa.
Mỗi lần sửa thực đơn qua mã nguồn là một lần gửi phiên bản. Nếu thực đơn thay đổi hằng ngày, phải làm trang quản trị để quán tự sửa, đừng chờ lập trình viên.
Không. Quán nhỏ có thể dừng ở nhóm một và hai: thực đơn, đặt món, mã QR tại bàn. Thêm nhóm khác khi thấy khách dùng.
Có bắt buộc tích hợp thanh toán không?
Không, nhưng phải theo chính sách hiển thị giá nêu ở trên. Thanh toán khi nhận hàng và chuyển khoản là hai phương thức có sẵn trong Checkout SDK.
Cần giấy phép gì để làm Mini App cho quán ăn?
Theo trang xác thực: giấy xác nhận ngành nghề kinh doanh phù hợp và giấy chứng nhận cơ sở đủ điều kiện an toàn thực phẩm. Quán bán rượu còn có yêu cầu giấy phép riêng. Anh chị mở lại trang chính thức trước khi nộp.
Mỗi bàn có mã QR riêng được không?
Về kỹ thuật tài liệu có liên kết mở mini app kèm tham số và hàm đọc tham số. Việc dùng tham số làm số bàn là cách thiết kế của tôi, nên thử trước ở một bàn.
Có gửi tin nhắn cho khách sau khi mua được không?
Tài liệu có mục gửi thông báo qua OA hoặc ZBS, kèm quy định riêng. Anh chị đọc điều kiện đó và bảng giá chính thức trước khi lên kế hoạch.
Nguồn: docs.zaloplatforms.com/docs/MA (intro/intro/entry-point-access, intro/best-practices/interact-with-zalo-app, call-restful-api, widget-follow-oa, intro/send-notification, api/intro, api/routing/getRouteParams, intro/request-permission, checkoutSdk/intro) và miniapp.zaloplatforms.com/documents (mini-app-verification, regulated-products-and-services, zalo-mini-app-censorship-policy), kiểm ngày 09/11/2026.
Zalo Mini App có thanh toán phải tích hợp Checkout SDK của nền tảng. Có hai giải pháp: nền tảng làm trung gian xử lý với ZaloPay, MoMo, VNPay, PayME, hoặc tự xử lý giao dịch khi được duyệt. Điều kiện cần có gồm xác thực chủ sở hữu và máy chủ nhận kết quả.
Trong Zalo Mini App, anh chị lấy số điện thoại bằng hàm getPhoneNumber của zmp-sdk. Người dùng đồng ý trên màn hình xin quyền, mini app nhận một mã token, rồi máy chủ của doanh nghiệp đổi mã đó lấy số qua Zalo Open API. Mã chỉ dùng được một lần và hết hạn sau 2 phút.
Mini App phải qua hai việc trước khi mở cho mọi người dùng: xác thực chủ sở hữu và xét duyệt phiên bản. Theo chính sách, thời gian kiểm duyệt là 3 ngày làm việc. Hồ sơ cần chuẩn bị gồm giấy tờ xác thực, giấy phép con nếu ngành có điều kiện, và bản Testing đã chạy ổn.