Quy trình duyệt Zalo Mini App: hồ sơ cần chuẩn bị và lý do hay bị từ chối
Tất cả blog / Hướng dẫn / Quy trình duyệt Zalo Mini App: hồ sơ cần chuẩn bị và lý do hay bị từ chối
Lộc Nguyễn13 thg 11, 20269 phút đọc
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.
Bài này đi từ bản chạy thử đến bản công khai, theo tài liệu và chính sách của Zalo Mini App mà tôi mở ngày 09/11/2026. Thứ tự: các trạng thái của một phiên bản, ba lớp kiểm duyệt, hồ sơ xác thực, danh mục tôi soát trước khi gửi, các lý do bị từ chối có trong chính sách, điểm bất lợi, câu hỏi thường gặp. Tôi chỉ nêu lý do từ chối có chữ trong tài liệu. Những chuyện kiểu «năm ngoái bạn tôi bị từ chối vì…» không đưa vào đây vì không kiểm chứng được.
Một phiên bản đi qua những trạng thái nào
Tài liệu «Phát hành Mini App» liệt kê bốn trạng thái nối nhau, và bản chạy thử Development đứng trước chúng. Hiểu đúng thứ tự giúp anh chị biết mình đang kẹt ở trạm nào.
Mini app đi qua các trạm kiểm tra của quy trình duyệt trước khi mở cho mọi người dùng.
Development. Bản xuất bản nhanh để thử trên Zalo, không hiện trong mục Quản lý phiên bản và bị bản Development mới ghi đè.
Testing. Bản được đánh số và lưu trong Quản lý phiên bản. Chỉ bản Testing mới gửi được yêu cầu xét duyệt.
Chờ xét duyệt. Sau khi gửi, trạng thái đổi sang đây; Zalo Team rà theo chính sách Zalo Mini App.
Đã duyệt. Bản qua kiểm duyệt nhưng chưa tới người dùng.
Publish. Anh chị chọn Publish để phân phối ứng dụng tới người dùng.
Điều kiện tiên quyết ghi ngay đầu trang: Mini App phải hoàn tất xác thực trước khi gửi yêu cầu xét duyệt. Gửi yêu cầu ở trang Quản Lý Zalo Mini App, mục Quản lý phiên bản, Danh sách phiên bản.
Ba lớp kiểm duyệt
Trang «Chính sách kiểm duyệt» chia việc rà soát thành các lớp sau:
Lớp
Mục đích theo tài liệu
Nội dung kiểm tra
Định danh chủ sở hữu (KYB)
Xác minh Merchant là pháp nhân hợp pháp, có quyền kinh doanh đúng ngành đăng ký
Liên kết OA đã xác thực hoặc nộp tài liệu; giấy phép con nếu ngành có điều kiện
Nội dung
Không chứa nội dung vi phạm pháp luật Việt Nam và chính sách
Nội dung khớp danh mục đã đăng ký, không hàng hoá cấm, không vật phẩm ảo, không link điều hướng ngoài, không vi phạm sở hữu trí tuệ
Kỹ thuật
Hoạt động ổn định, an toàn dữ liệu
Không crash, không treo; chỉ xin quyền cần thiết; xử lý dữ liệu theo Nghị định 13/2023/NĐ-CP; kết nối API qua HTTPS với chứng chỉ SSL hợp lệ
Giao diện (UI)
Trải nghiệm nhất quán trên nền tảng
Theo bộ Design Guidelines
Hồ sơ xác thực cần chuẩn bị
Theo trang «Quy trình xác thực Mini App» (cập nhật lần cuối 04/12/2025), từ ngày 15/10/2025 thương nhân cần xác thực một hoặc cả hai bước tuỳ ngành nghề. Bước bắt buộc là xác thực chủ sở hữu, áp dụng cho mọi Mini App. Với doanh nghiệp hoặc hộ kinh doanh, hình thức là OA doanh nghiệp, hoặc giấy tờ gồm giấy chứng nhận đăng ký doanh nghiệp hay hộ kinh doanh cùng giấy tờ tuỳ thân của người đại diện pháp luật.
Trang mô tả khởi tạo tóm hai phương thức:
Phương thức A, qua OA đã xác thực. Dành cho doanh nghiệp đã có OA xác thực chính chủ. Xử lý trong 3 ngày làm việc. Tài liệu khuyến nghị chọn cách này nếu đã có OA.
Phương thức B, nộp tài liệu. Dành cho trường hợp chưa có OA hoặc OA chưa xác thực. Nộp bộ tài liệu KYB, xử lý 3 đến 5 ngày làm việc kể từ khi nhận đủ.
Bước bổ sung là giấy phép cho ngành có điều kiện. Danh sách trong trang xác thực gồm cơ quan nhà nước, tài chính, y tế, giáo dục, bất động sản, thương mại, F&B, giao thông vận tải và tiện ích đời sống. Ví dụ với F&B (kinh doanh hoặc quản lý dịch vụ ăn uống), yêu cầu là 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. Trang ghi rõ danh sách có thể thay đổi, nên anh chị mở lại trang chính thức ngay trước khi chuẩn bị hồ sơ.
Danh mục tôi soát trước khi bấm gửi
Đây là danh sách của tôi, mỗi dòng bám một câu có trong chính sách hoặc trang phát hành:
Tên, logo, mô tả khớp chức năng. Logo là của chính doanh nghiệp, không dùng logo của ứng dụng hay nhãn hàng khác, không chứa số điện thoại hay mã QR, không nền trong suốt. Mô tả không chứa đường liên kết.
Tên đúng quy định. Không viết hoa toàn bộ, không dùng danh từ chung, không chứa các từ «App», «Mini App», «Zalo» hay ký tự đặc biệt, emoji. Nên có tiền tố hoặc hậu tố để người dùng biết đơn vị sở hữu.
Danh mục dịch vụ khớp danh mục đã đăng ký.
Mọi tính năng chạy thật. Chính sách xếp tính năng không dùng được hoặc ở trạng thái Demo vào nhóm vi phạm.
Không có link ra ngoài. Không điều hướng người dùng ra ngoài ứng dụng, trừ việc hiển thị chính sách bảo mật hay điều khoản; khi đó ẩn nút dẫn ra ngoài hoặc nhúng tài liệu thành popup ngay trong Mini App.
Tốc độ. Chính sách ghi mốc đạt chuẩn: LCP dưới 2,5 giây, thời gian tải trang dưới 1,5 giây; tải Mini App hay tính năng quá 10 giây là vi phạm.
Giao diện. Mỗi màn hình tối đa một hành động chính, vùng chạm tối thiểu 44 x 44 pt, thanh điều hướng dưới tối đa 4 tab, có phản hồi loading khi xử lý quá 300 mili giây, không đặt phần tử che menu Zalo cố định.
Quyền người dùng. Xin đúng ngữ cảnh, không hiện bảng xin quyền ngay khi vừa vào, cho phép từ chối mà vẫn dùng được các tính năng khác.
Có thanh toán thì có Checkout SDK. Nếu hiển thị giá mà chưa tích hợp, chính sách yêu cầu bỏ giá và đổi chức năng sang «Liên hệ» hoặc «Tư vấn».
Chính sách và điều khoản rõ ràng. Tiêu đề nói rõ là của Mini App nào, đơn vị kinh doanh nào.
Những lý do bị từ chối có trong chính sách
Trang chính sách trình bày theo cặp «vi phạm» và «đạt chuẩn». Các mục vi phạm hay gặp với doanh nghiệp nhỏ:
Đăng nhập bằng Google, Facebook, hoặc khuyến khích tải ứng dụng riêng.
Treo banner quảng cáo kiếm tiền trong ứng dụng khi chưa được Zalo chấp thuận.
Bán nội dung số như khóa học online, gói nghe nhạc, gói xem phim.
Có tính năng mạng xã hội như đăng bài, bình luận, hoặc tính năng cạnh tranh trực tiếp với sản phẩm trong hệ thống Zalo.
Bắt người dùng đăng ký hay đăng nhập để dùng, trừ Mini App nội bộ (trường học, công ty) hoặc trường hợp nền tảng đánh giá cần màn hình đăng nhập.
Xin quyền khi người dùng vừa vào Mini App, hoặc không nêu rõ mục đích xin quyền. Riêng với số điện thoại, tài liệu getPhoneNumber ghi nền tảng sẽ từ chối xét duyệt luồng xin quyền không rõ mục đích.
Ảnh không tải được, lỗi font, màn hình trắng hoặc tối, bị treo.
Chia sẻ dữ liệu cá nhân với bên thứ ba mà không thông báo hay không có sự cho phép.
Điểm bất lợi và rủi ro của quy trình duyệt
Thời gian không hoàn toàn trong tay mình. Mốc 3 ngày làm việc không gồm thứ Bảy, Chủ Nhật, ngày lễ, và theo cách tôi hiểu chỉ tính cho một lượt xét. Bị từ chối thì sửa rồi nộp lại, thời gian cộng dồn. Với đợt ra mắt gắn ngày khuyến mãi, tôi khuyên nộp sớm.
Ngành có điều kiện đòi hồ sơ nặng. Ngành F&B, y tế, bất động sản có danh mục giấy phép riêng, và chính sách xét duyệt nhóm ngành đặc thù có mục riêng.
Quyền API được duyệt cùng phiên bản mới. Các quyền cần Zalo cho phép phải gửi yêu cầu kèm lý do và hình ảnh; bộ phận kiểm duyệt xét khi xét duyệt phiên bản mới.
Đổi thông tin sau khi tạo phải qua ticket. Tên, mô tả, logo, banner, loại hình sở hữu, danh mục.
Duy trì sau khi lên. Chính sách yêu cầu Mini App giữ xác thực hợp lệ, tính năng chính ổn định, và tối thiểu 10 lượt truy cập mỗi tháng. Chưa đạt trong 3 tháng thì có nguy cơ bị hạn chế hiển thị hoặc vô hiệu hóa.
Không tìm thấy trong ô tìm kiếm Zalo không phải lỗi của anh chị. Tài liệu giải thích phía vận hành có thể tắt tìm kiếm với Mini App, ví dụ khi dùng form đăng nhập truyền thống. Muốn mở lại phải sửa luồng rồi gửi phiên bản mới, ghi yêu cầu mở lại tìm kiếm trong mô tả.
Chính sách ghi kiểm duyệt trong vòng 3 ngày làm việc, không tính thứ Bảy, Chủ Nhật và ngày lễ. Xác thực chủ sở hữu có thời gian riêng: 3 ngày làm việc qua OA, 3 đến 5 ngày làm việc nếu nộp tài liệu.
Duyệt Zalo Mini App có mất phí không?
Các trang tôi mở không nêu khoản phí duyệt, nên tôi không ghi con số. Anh chị xem điều khoản trong Thỏa Thuận Chương Trình Zalo Mini App trước khi nộp.
Chưa có OA đã xác thực thì làm sao?
Chọn phương thức B: nộp bộ tài liệu KYB gồm đăng ký kinh doanh, giấy tờ sở hữu thương hiệu, thông tin đại diện pháp luật và email, theo trang chính sách.
Bị từ chối thì làm gì?
Sơ đồ quy trình ghi: từ chối thì sửa theo phản hồi và nộp lại. Kết quả được gửi qua OA, và với yêu cầu cấp quyền còn có thông báo ở trang quản lý.
Có thể đăng bản Testing cho mọi người dùng không?
Không. Bản Development và Testing chỉ mở được bằng tài khoản Developer hoặc Admin của Mini App. Muốn công khai phải qua xét duyệt rồi chọn Publish.
Nguồn: docs.zaloplatforms.com/docs/MA (intro/public-mini-program, intro/censorship-overview, intro/getting-started, intro/overview, intro/request-permission, getting-started/frequently-solved-issues, api getPhoneNumber) và miniapp.zaloplatforms.com/documents (zalo-mini-app-censorship-policy, mini-app-verification), 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.
Để tạo Zalo Mini App đầu tiên, anh chị cần bốn việc nối nhau: một Zalo App ở developers.zalo.me, một Mini App trong trang quản lý để lấy Mini App ID, một dự án mã nguồn tạo bằng Zalo Mini App Extension trên Visual Studio Code, rồi chạy thử trên điện thoại bằng chế độ Device hoặc bản Development.