MoMo Merchant là tài khoản doanh nghiệp của MoMo, quản lý trên cổng M4B (MoMo for Business) tại business.momo.vn. Muốn nhận thanh toán MoMo trên website, doanh nghiệp phải đăng ký MoMo Merchant, được MoMo xác thực hồ sơ, rồi dùng bộ thông tin tích hợp (Partner Code, Access Key, Secret Key) để gọi API tạo giao dịch. Ví MoMo cá nhân không dùng được cho việc này.
MoMo Merchant là gì?
MoMo Merchant (còn gọi là tài khoản MoMo Business) là tài khoản dành cho tổ chức và hộ kinh doanh, tách biệt hoàn toàn với ví MoMo cá nhân. Tài liệu của MoMo mô tả M4B là cổng thông tin riêng cho doanh nghiệp, nơi quản lý toàn bộ hồ sơ: thông tin pháp lý, báo cáo, marketing, tài chính và thông tin tích hợp kỹ thuật.
Điểm quan trọng với website: chỉ tài khoản merchant mới được cấp Partner Code và khoá bí mật để ký yêu cầu thanh toán. Ví cá nhân không có Partner Code nên không qua được bước xác thực chữ ký của MoMo.
Cách đăng ký MoMo Merchant từng bước
- Truy cập business.momo.vn, chọn Đăng ký và điền thông tin tài khoản (email, số điện thoại người đại diện).
- Khai báo thông tin pháp lý và thông tin kinh doanh: loại hình (doanh nghiệp hoặc hộ kinh doanh), ngành nghề, kênh bán (website, ứng dụng, tại quầy).
- Tải lên hồ sơ chứng minh theo loại hình (xem bảng bên dưới).
- Nhận thông tin tích hợp cho môi trường test ngay sau khi đăng ký, để đội kỹ thuật làm và kiểm thử trước.
- Hoàn tất kiểm thử nghiệm thu (UAT) trên môi trường test.
- Chờ MoMo xác thực hồ sơ và hoàn tất hợp đồng. Khi M4B ở trạng thái đã xác thực, doanh nghiệp được cấp thông tin tích hợp cho môi trường production.
Hồ sơ đăng ký MoMo Merchant cần những gì?
| Loại hình | Giấy tờ chính | Ghi chú |
|---|---|---|
| Doanh nghiệp (công ty) | Giấy chứng nhận đăng ký doanh nghiệp, giấy tờ tuỳ thân của người đại diện pháp luật, tài khoản ngân hàng đứng tên doanh nghiệp | Nếu người đăng ký không phải người đại diện pháp luật thì cần giấy uỷ quyền |
| Hộ kinh doanh | Giấy chứng nhận đăng ký hộ kinh doanh, CCCD của chủ hộ | Tài khoản nhận tiền theo quy định của MoMo cho hộ kinh doanh |
| Ngành đặc thù (y tế, giáo dục...) | Giấy phép hoạt động chuyên ngành bổ sung | MoMo có thể yêu cầu thêm giấy tờ tuỳ ngành |
Partner Code MoMo là gì và lấy ở đâu?
Sau khi đăng ký, trong mục thông tin tích hợp trên M4B có ba giá trị đội kỹ thuật cần:
- Partner Code: mã định danh merchant, không bí mật, gửi kèm mọi yêu cầu tạo giao dịch.
- Access Key: đi kèm Partner Code khi ký yêu cầu.
- Secret Key: khoá bí mật để tạo chữ ký HMAC SHA256. Chỉ lưu ở máy chủ, không bao giờ đưa vào mã chạy trên trình duyệt.
Bộ khoá của môi trường test và production là hai bộ khác nhau. Lỗi hay gặp khi go-live là đổi địa chỉ API sang production nhưng vẫn giữ Partner Code của môi trường test, hoặc ngược lại.
3 kiểu tích hợp MoMo cho doanh nghiệp
- Link thanh toán: tạo đường dẫn thanh toán và gửi cho khách qua Zalo, email, SMS. Khách bấm, mở ứng dụng MoMo và trả tiền. Không cần lập trình.
- Mã QR tại quầy: QR cố định cho cửa hàng hoặc QR động theo từng đơn. Phù hợp F&B và bán lẻ.
- Cổng thanh toán qua API cho website, ứng dụng: khách thanh toán ngay trong luồng đặt hàng, sau đó quay lại trang của bạn. Trải nghiệm liền mạch nhất nhưng cần đội kỹ thuật.
Môi trường test và production
| Test (sandbox) | Production | |
|---|---|---|
| Khi nào có | Ngay sau khi đăng ký M4B | Sau khi hồ sơ được xác thực và UAT đạt |
| Địa chỉ API | test-payment.momo.vn | payment.momo.vn |
| Tiền thật | Không | Có |
| Bộ khoá | Partner Code, Access Key, Secret Key của test | Bộ khoá riêng của production |
Tích hợp kỹ thuật full API cho website Next.js
Với website chạy Next.js, luồng chuẩn là tạo một API route phía máy chủ gọi API tạo giao dịch của MoMo, không gọi thẳng từ trình duyệt:
- Route máy chủ (ví dụ /api/payment/momo/create) nhận orderId từ trình duyệt, KHÔNG nhận số tiền cuối cùng từ trình duyệt mà tự tính lại từ đơn hàng trong cơ sở dữ liệu, tránh khách sửa giá.
- Route dựng payload gồm Partner Code, orderId, requestId, amount, orderInfo, redirectUrl, ipnUrl, requestType, rồi ký HMAC SHA256 bằng Secret Key trên đúng chuỗi tham số theo thứ tự tài liệu MoMo quy định.
- Máy chủ gọi API tạo giao dịch của MoMo, nhận về payUrl hoặc deeplink, trả về cho trình duyệt để chuyển khách sang trang hoặc ứng dụng MoMo.
- Khách thanh toán xong, MoMo chuyển trình duyệt về redirectUrl (chỉ để hiển thị) và gọi ipnUrl phía máy chủ (nguồn xác nhận đáng tin).
- Route IPN xác minh lại chữ ký bằng Secret Key trước khi tin bất kỳ trường nào, đối chiếu amount với đơn hàng, rồi mới đánh dấu đơn đã thanh toán.
- Chạy hết luồng trên môi trường test, gồm cả trường hợp khách huỷ và giao dịch lỗi, trước khi đổi sang production.
Nên chọn kiểu tích hợp nào?
- Bán qua Zalo, Facebook, chưa có website bán hàng: link thanh toán là đủ.
- Cửa hàng, quán có quầy: QR tại quầy.
- Website hoặc ứng dụng có giỏ hàng: cổng thanh toán qua API, thường đi cùng VNPay hoặc ZaloPay để khách có thêm lựa chọn.
Cần tích hợp MoMo, VNPay cho website doanh nghiệp, liên hệ ALODEV qua trang /lien-he để được tư vấn luồng thanh toán phù hợp.
Câu hỏi thường gặp
MoMo Merchant là gì?
Là tài khoản doanh nghiệp của MoMo, quản lý trên cổng M4B tại business.momo.vn. Tài khoản này nhận thanh toán từ khách, xem báo cáo đối soát và được cấp Partner Code để tích hợp cổng thanh toán vào website, ứng dụng.
Hộ kinh doanh có đăng ký MoMo Merchant được không?
Được. Hộ kinh doanh đăng ký với giấy chứng nhận đăng ký hộ kinh doanh và CCCD của chủ hộ; ngành đặc thù có thể phải nộp thêm giấy phép. Ví MoMo cá nhân thì không dùng để tích hợp API được.
Partner Code MoMo lấy ở đâu?
Trong mục thông tin tích hợp trên M4B sau khi đăng ký. Bộ Partner Code, Access Key, Secret Key của môi trường test có ngay; bộ của production được cấp sau khi hồ sơ được xác thực.
Có test được trước khi hồ sơ được duyệt không?
Có. Theo tài liệu MoMo, sau khi đăng ký bạn nhận thông tin cho môi trường test và phải hoàn tất kiểm thử nghiệm thu (UAT) ở đó trước khi lên production.
Phí giao dịch MoMo Merchant là bao nhiêu?
Phí phụ thuộc ngành hàng, kiểu tích hợp và thoả thuận trong hợp đồng với MoMo, nên hỏi trực tiếp bộ phận merchant của MoMo (hotline 1900 636 652, email merchant.care@momo.vn theo tài liệu developers.momo.vn) để có mức phí áp dụng cho doanh nghiệp bạn.
