Tụi em thấy khách mua hosting ở MONA Host phần lớn làm web bán hàng, câu lặp đi lặp lại sau khi web chạy là: “Khách chuyển khoản xong, làm sao website biết để tự xác nhận đơn?” Từ năm 2022, tụi em đã dùng chính luồng này để hóa đơn hosting tự đóng khi tiền về. Tích hợp cổng thanh toán vào website bằng MONA Pay sẽ nối khoản tiền vào với mã đơn, đổi trạng thái và báo cho chủ shop suốt 24 giờ. Với 150 đơn mỗi tháng, web tự làm phần lặp lại thay cho 3 phút dò sao kê ở từng đơn. Tiền vẫn vào thẳng tài khoản ngân hàng của anh chị. Bắt đầu từ một đơn.

Web bán hàng đã chạy, nhưng tiền về vẫn mắc ở tay người

Website mở cửa đủ 24 giờ, còn khâu xác nhận tiền của nhiều shop vẫn dừng khi người trực đơn đi ngủ. Khách chuyển lúc 23 giờ, gửi ảnh qua Zalo rồi chờ tới sáng; người bán mở ứng dụng ngân hàng, dò tên, dò số tiền, quay lại WooCommerce và bấm đổi trạng thái. Tụi em gặp cảnh này nhiều ở nhóm khách vừa đưa web lên chạy, vì phần giao diện đã xong nhưng tích hợp cổng thanh toán vào website lại bị để sau cùng. Thế là đơn có, tiền có, máy chủ vẫn ghi “chờ thanh toán”.

Ba cách chữa tạm thường tạo thêm việc. Dò sao kê tay chậm và dễ bỏ sót, ảnh chụp bill chỉ là thứ khách gửi chứ chưa chứng minh tiền đã vào, còn mô hình giữ tiền ở một nơi khác khiến shop phải chờ rút hoặc đối soát. Với 150 đơn mỗi tháng, chỉ cần mất 3 phút kiểm một đơn là đã thành 450 phút, tương đương 7 giờ 30 phút chỉ để nhìn qua lại giữa hai màn hình. Bảy giờ đó quá phí.

Tích hợp cổng thanh toán vào website bằng MONA Pay
Khoản tiền vào được website và người vận hành nhận cùng lúc, thay vì chờ một người dò tay.
Cách shop đang làm Chỗ tiện Chỗ dễ sai Khi nào còn dùng được
Dò sao kê bằng mắt Không cần cài thêm gì Chậm, lệch ca trực, nhầm hai đơn cùng tiền Vài đơn mỗi tháng
Khách gửi ảnh bill qua Zalo Hai bên đều quen thao tác Vẫn phải mở ngân hàng kiểm lại, ảnh sửa được Chỉ để trao đổi, không dùng làm căn cứ giao hàng
Tiền nằm ở bên giữ hộ Thu được nhiều phương thức Có lịch rút, thời gian đối soát và biểu phí riêng Khi shop thật sự cần thẻ hoặc ngoại tệ
Chuyển khoản tự báo có Tiền vào tài khoản của shop, web nhận tin Cần cấu hình khớp đơn ban đầu WordPress, WooCommerce và dịch vụ thu VND

Quan điểm của MONA khá rõ: ảnh bill hợp để nhắn cho nhau, nhưng giao hàng phải dựa trên giao dịch mà ngân hàng đã ghi nhận. Shop ít đơn vẫn tự kiểm được và chưa cần thuê ai. Khi web bắt đầu có đơn ngoài giờ, nhiều người cùng trực hoặc doanh thu nằm trong từng lần xác nhận, tích hợp cổng thanh toán vào website trở thành một phần vận hành chứ không còn là món trang trí ở trang thanh toán.

Tích hợp cổng thanh toán vào website là nối tiền về với đúng đơn

Người không rành kỹ thuật dễ hình dung việc tích hợp cổng thanh toán vào website qua bốn điểm nối. Điểm đầu là đơn hàng có mã và số tiền. Điểm thứ hai là mã VietQR hoặc tài khoản ảo để khách chuyển đúng dữ liệu, điểm thứ ba là tín hiệu báo có từ ngân hàng, điểm cuối là website nhận tín hiệu rồi tự đổi trạng thái. Trong một ca 10 phút có 2 đơn cùng trị giá 350.000đ, VA hoặc mã đơn giúp website tách chúng trước khi đổi trạng thái. Chỉ cần đứt một điểm, đơn vẫn nằm im.

MONA Pay là cổng thanh toán và API ngân hàng của The MONA Group, giúp doanh nghiệp Việt Nam nhận và xác nhận tiền chuyển khoản theo thời gian thực qua tài khoản ảo (VA), VietQR, webhook và Telegram, thiết kế để cả lập trình viên lẫn AI agent tích hợp trong vài phút. Tiền không chạy qua MONA Pay. Hệ thống nhận thông báo giao dịch, ghi vào dashboard, gửi webhook tới website và gửi tin Telegram nếu anh chị bật kênh này.

Dashboard MONA Pay hướng dẫn kích hoạt nhận tiền cho website
Dashboard gom bước nối ngân hàng, webhook, Telegram và sổ giao dịch vào một chỗ.

Khi tích hợp cổng thanh toán vào website WordPress, webhook là người đưa tin cho máy. Nó gửi số tiền, nội dung chuyển khoản, thời gian, số tài khoản nhận và transaction_code; WooCommerce lấy mã đơn trong nội dung hoặc số VA để tìm đúng đơn, so số tiền rồi gọi lệnh hoàn tất thanh toán. Telegram làm việc khác: báo cho chủ shop, nhân viên bán hàng và kế toán cùng biết tiền đã vào; hai kênh chạy song song.

Tụi em khuyên tách rõ “báo cho người” và “báo cho phần mềm” ngay từ lúc dựng luồng. Nhóm Telegram giúp kiểm tra bằng mắt, còn webhook mới làm đơn tự đổi trạng thái. Dùng Telegram mà vẫn bắt nhân viên bấm tay thì shop đã bỏ được khâu mở ứng dụng ngân hàng, nhưng chưa tự động hóa xong. Còn một nửa.

MONA Host đã thu tiền gia hạn bằng luồng này từ năm 2022

MONA Host bán thứ có ngày hết hạn rõ ràng: hosting, tên miền và dịch vụ máy chủ. Trước đây, một khoản gia hạn chuyển tới vào cuối ngày kéo theo ba việc, gồm tìm hóa đơn, xác nhận đã nhận tiền và cộng thêm thời hạn cho dịch vụ. Từ năm 2022, tụi em tự xây hệ thống nhận biến động ACB để thu tiền cho chính MONA; khách chuyển khoản thì hóa đơn tự đóng, hosting hoặc tên miền tự gia hạn theo dữ liệu trong đơn. Câu hỏi “tiền về chưa” bớt khỏi ca trực.

Chi tiết nghe nhỏ nhưng làm vận hành nhẹ hẳn: nội dung chuyển khoản phải mang đúng mã, khoản tiền vào phải được ghi lại, và một mã giao dịch gửi lại hai lần vẫn chỉ được tính một lần. Tụi em còn giữ sổ giao dịch để kế toán lọc theo ngày, tài khoản, trạng thái webhook rồi xuất dữ liệu đối chiếu. Bản chất tích hợp cổng thanh toán vào website tại MONA Host là vậy, không có phép màu, chỉ có từng điểm nối làm đúng việc của nó.

Lịch sử giao dịch chuyển khoản của website WooCommerce
Sổ giao dịch giữ dấu vết để hóa đơn tự đóng vẫn đối chiếu lại được khi cần.

Hệ thống ấy tiếp tục được dùng cho phần mềm giao khách, và hơn 6.000 khách hàng mới của MONA đã đi qua luồng thu tiền được công bố trên monapay.vn. Ngày 29/08/2026, tụi em mới mở MONA Pay cho mọi doanh nghiệp đăng ký. Thứ tự này quan trọng: tự dùng trước, chịu những lỗi vặt của chính mình trước, rồi mới đóng gói để người khác tích hợp cổng thanh toán vào website.

Ngày 03/09/2026, tụi em còn đóng vai một chủ tiệm hoa mới, đăng ký từ đầu, tạo API key, đi hết wizard webhook 5 bước, nối Telegram và bật 2FA. Có đoạn phải dừng lại cất client secret vì hệ thống chỉ hiện một lần, có đoạn phải lưu 10 mã dự phòng trước khi thoát màn hình xác thực. Mấy thao tác lẻ đó giúp tụi em viết hướng dẫn cho người mới bằng đúng thứ vừa bấm, thay vì kể lại theo trí nhớ. Làm thật rồi mới hướng dẫn.

Bốn bước tích hợp cổng thanh toán WordPress và WooCommerce

Shop đang dùng hosting WordPress hoặc hosting thương mại điện tử có thể đi theo đúng bốn bước dưới đây. Bản cài plugin không bắt anh chị viết PHP, sửa giao diện hay chạm vào cơ sở dữ liệu. Anh chị cần quyền quản trị WordPress, một website có HTTPS, tài khoản ngân hàng đang hỗ trợ trong MONA Pay và khoảng 15 phút để nhận OTP. Chuẩn bị vậy là đủ.

  1. Đăng ký MONA Pay: vào my.monapay.vn, tạo tài khoản và đăng nhập. Tài khoản mới dùng ngay, không có vòng chờ xét duyệt.
  2. Tạo key: mở Dashboard, vào API Keys, bấm Tạo key. Sao chép client_idclient_secret sang nơi cất an toàn vì secret chỉ hiện một lần.
  3. Nối ngân hàng: mở Ngân hàng và VA, nhập số tài khoản cùng số điện thoại đăng ký với ngân hàng. Với ACB đang chạy trực tiếp, anh chị nhập OTP lần đầu để tạo VA, rồi OTP lần hai để bật nhận thông báo giao dịch.
  4. Cài plugin WooCommerce: tải plugin MONA Pay cho WooCommerce trên GitHub, cài file ZIP trong WordPress, dán key và chạy một đơn thử. Web làm tại MONA thì tụi em cài và kiểm giúp.
API key dùng để tích hợp MONA Pay vào WordPress
API key được tạo một lần rồi cất vào cấu hình website hoặc biến môi trường.

Ai mới dựng web từ đầu có thể đọc thêm cách cài WordPress lên hosting và cách chọn hosting cho WordPress trước khi làm phần nhận tiền. SSL cũng phải chạy đúng vì webhook cần URL HTTPS; phần giải thích ở bài SSL là gì, còn web chưa có chứng chỉ thì xem gói SSL cho website. Đừng bỏ qua HTTPS.

Sau khi cài, tạo một sản phẩm giá 10.000đ hoặc đơn nháp, quét QR bằng một tài khoản khác rồi nhìn ba nơi: ứng dụng ngân hàng, dashboard MONA Pay và trạng thái đơn WooCommerce. Nếu cả ba khớp, tích hợp cổng thanh toán vào website đã hoàn tất ở mức vận hành. Webhook cần trả HTTP 200 trong 10 giây. Nếu chỉ Telegram báo mà đơn chưa đổi, bấm mở lịch sử webhook để đọc mã HTTP trước khi sửa lung tung.

Trường hợp này anh chị tự làm được, không cần thuê. Web đã sửa quy trình thanh toán quá sâu, có nhiều trạng thái riêng hoặc dùng mã đơn khác chuẩn WooCommerce thì hãy nhờ người đang quản trị web kiểm quy tắc khớp tiền. Tụi em không khuyên bật thật trước khi chạy đủ đơn đúng tiền, thiếu tiền, sai nội dung và webhook gửi lại. Bốn ca đó bắt được phần lớn lỗi.

Tài khoản ảo, VietQR và webhook chia nhau ba việc

Ba khái niệm này hay bị gộp thành một khi tích hợp cổng thanh toán vào website, nên chủ shop khó biết mình đang thiếu gì: tài khoản ảo, gọi tắt là VA, giúp nhận diện khoản tiền thuộc đơn hoặc khách nào. VietQR điền sẵn số tài khoản, số tiền và nội dung để người mua đỡ gõ sai. Webhook mang kết quả báo có từ MONA Pay về WordPress để website tự xử lý.

Biểu mẫu tạo tài khoản ảo để khớp đơn hàng
Mỗi VA mang dấu định danh riêng, giúp khoản tiền về được gắn đúng đơn hoặc đúng khách.

Ví dụ ba khách cùng mua sản phẩm 350.000đ trong 10 phút. Nếu shop chỉ nhìn số tiền, ba dòng giao dịch giống nhau và nội dung có người ghi “ck”, người ghi tên, người để trống. Khi mỗi đơn có một VA hoặc mã đơn được điền sẵn trong VietQR, hệ thống có thêm dấu để nhận diện; webhook gửi dấu đó về WooCommerce, đối chiếu số tiền rồi chuyển đơn sang đã thanh toán. Khớp bằng dữ liệu, không đoán.

Màn hình tạo VietQR động cho đơn hàng website
VietQR động giảm hai lỗi thường gặp là gõ sai số tiền và gõ sai nội dung chuyển khoản.
Thành phần Giải việc gì Dữ liệu website dùng Sai thì biểu hiện ra sao
Tài khoản ảo Nhận diện đơn hoặc khách account_number Tiền vào nhưng web không biết gắn cho ai
VietQR động Điền đúng số tiền và nội dung Mã đơn, số tiền Khách gõ sai hoặc thiếu dữ liệu
Webhook Báo cho website JSON có chữ ký Dashboard có tiền nhưng đơn chưa đổi
Telegram Báo cho con người Số tiền, thời gian, nội dung Máy chạy đúng nhưng nhóm vận hành không thấy

Tụi em thường ưu tiên VA cho khoản thu lặp lại theo khách, còn đơn bán lẻ dùng VietQR động kèm mã đơn đã đủ rõ. Tích hợp cổng thanh toán vào website không bắt mọi shop phải dùng cấu hình nặng như nhau. Shop 150 đơn một tháng cần ít lớp hơn hệ thống bán khóa học có 10.000 học viên, nhưng cả hai vẫn phải giữ transaction_code để chống xử lý trùng.

Bảng phí cho thấy chuyển khoản tự báo có giữ lại bao nhiêu tiền

Chữ “miễn phí” chỉ có nghĩa khi đặt cạnh các đường tiền khác. Biểu phí thương mại điện tử của VietinBank, hiệu lực 22/04/2026, ghi rõ mức theo tỷ lệ và phí xử lý, chưa gồm VAT. Trang phí người bán của PayPal, kiểm ngày 28/05/2026, nêu phí nhận giao dịch quốc tế 4,40% cộng phí cố định, rút về ngân hàng Việt Nam 60.000đ mỗi lần và phần quy đổi tiền tệ 4% ở trường hợp được công bố. Mỗi đường phục vụ một nhu cầu.

Đường tiền Biểu phí tham chiếu Tiền đi đâu Hợp với việc nào
Thẻ nội địa NAPAS nối trực tiếp 0,5% đến 0,7% Qua hệ thống chấp nhận thẻ Shop cần thu thẻ nội địa
Thẻ nội địa nối gián tiếp 1,09% + 1.818đ mỗi giao dịch Qua đường chấp nhận thẻ Hạ tầng đã dùng kết nối gián tiếp
Visa hoặc Mastercard phát hành trong nước 1,818% đến 2,182% + 4.200đ Qua cổng thẻ Khách muốn trả bằng thẻ quốc tế phát hành tại Việt Nam
Visa hoặc Mastercard phát hành nước ngoài 3,7% đến 3,8% + 4.500đ + 700.000đ mỗi tháng duy trì cổng Qua cổng thẻ Shop bán cho khách quốc tế
PayPal 4,40% + 0,30 USD khi nhận USD; có phí rút và quy đổi Số dư PayPal rồi rút về ngân hàng Bán xuyên biên giới
Chuyển khoản tự báo có qua MONA Pay 0% + 0đ trong gói Miễn phí 500 khoản mỗi tháng Thẳng tài khoản ngân hàng của shop Thu chuyển khoản VND trên website

Báo Điện tử Chính phủ ngày 05/02/2024 dẫn thông tin giao dịch chuyển mạch dưới 1 triệu đồng đã được NAPAS miễn toàn bộ phí, nhóm này chiếm 65% lượng giao dịch chuyển tiền qua hệ thống trong số liệu được nêu. VietQR vì thế rất hợp thói quen chuyển khoản của khách Việt. Phần MONA Pay thu là phí phần mềm nhận báo có theo số khoản, không lấy phần trăm giá trị tiền.

Bảng phí MONA Pay tính theo khoản tiền vào
Năm gói công khai được chia theo số khoản tiền vào trong một tháng dương lịch.

Lấy một phép tính minh họa cho shop 150 đơn mỗi tháng, giá trị trung bình giả định 500.000đ, doanh thu chuyển qua đường thanh toán là 75.000.000đ. Thẻ nội địa trực tiếp tốn khoảng 375.000đ đến 525.000đ; đường gián tiếp 1,09% cộng phí xử lý thành 1.090.200đ; Visa hoặc Mastercard phát hành trong nước thành khoảng 1.993.500đ đến 2.266.500đ. Thẻ phát hành nước ngoài cộng phí duy trì cổng thành khoảng 4.150.000đ đến 4.225.000đ, chưa VAT. MONA Pay ở mức 0đ vì 150 khoản vẫn nằm dưới hạn mức 500.

Đây là phép tính giả định để anh chị nhìn ra độ chênh, không phải lời khuyên bỏ thẻ. Khách muốn trả góp, dùng thẻ công ty hoặc mua từ nước ngoài thì cổng thẻ và PayPal làm đúng việc hơn. Shop bán chủ yếu trong nước, biên lợi nhuận mỏng và khách quen quét VietQR thì tích hợp cổng thanh toán vào website bằng chuyển khoản tự báo có giữ được phần tiền vốn đang bị tỷ lệ phí ăn vào, vì vậy hãy chọn đúng đường tiền.

Năm gói MONA Pay cho website bán hàng
Gói Miễn phí có đủ tính năng, còn gói trả phí mở rộng số khoản tiền vào và mức hỗ trợ.
Gói MONA Pay Giá mỗi tháng Khoản tiền vào mỗi tháng Giá trả năm
Miễn phí 500
Khởi nghiệp 99.000đ 2.000 990.000đ
Kinh doanh 299.000đ 10.000 2.990.000đ
Doanh nghiệp 799.000đ 50.000 7.990.000đ
Quy mô lớn 1.990.000đ 300.000 19.900.000đ

Trả năm được tính bằng 10 tháng. Một khoản tiền vào mới tính một giao dịch; tiền ra, dữ liệu sandbox và webhook gửi lại không tính. Khách đang làm web, phần mềm hoặc dùng hosting tại MONA được miễn phí hoàn toàn, đội MONA gán gói khi bàn giao hoặc khi anh chị gọi 1900 636 648. Bảng giá cập nhật ở trang giá MONA Pay.

150 đơn không cần đổi lấy 7 giờ 30 phút dò tiền

Anh chị đã bỏ công dựng web, mua hosting, làm sản phẩm, kéo khách tới trang thanh toán. Đừng để khâu cuối cùng quay về một người mở ứng dụng ngân hàng rồi bấm từng đơn. Với 150 khoản mỗi tháng, gói Miễn phí đã đủ chạy thật; khách MONA còn được miễn phí hoàn toàn.

Tạo tài khoản và thử một đơn Gọi 1900 636 648

Nhiều tài khoản ngân hàng vẫn về một dashboard, không chia sổ

MONA Pay thiết kế cho nhiều ngân hàng, nối nhiều tài khoản ở nhiều ngân hàng về một dashboard; ACB đang chạy trực tiếp (tụi em chạy thật với ACB từ 2022), các ngân hàng khác đang nối thêm theo lộ trình, bảng trạng thái tại monapay.vn/ngan-hang. Cách nói này quan trọng với chủ shop. Phần tích hợp của website được dựng 1 lần, còn tài khoản ngân hàng được thêm dần trong lớp MONA Pay. Mỗi tài khoản ACB dùng 2 lần OTP ở bước liên kết ban đầu. WooCommerce vẫn giữ nguyên khi có thêm kết nối.

Khi có nhiều tài khoản, anh chị bấm vào từng giao dịch để kiểm đúng người cần biết. Nhóm bán hàng nhận tin của VA thuộc shop, nhóm kế toán nhận mọi giao dịch, còn webhook của website chỉ nghe tài khoản gắn với đơn online. Telegram hỗ trợ group_idtopic_id, nên cùng một nhóm vẫn tách được chủ đề bán hàng với chủ đề kế toán. Rõ từ đầu.

Thiết lập Telegram báo tiền về cho chủ shop
Một cấu hình Telegram nhận mọi tài khoản hoặc chỉ một VA, rồi gửi về đúng nhóm và chủ đề.

Chủ shop không cần đưa điện thoại đang đăng nhập ngân hàng cho nhân viên. Nhân viên chỉ ở trong nhóm Telegram của ca trực, thấy số tiền, nội dung và thời gian; khi nghỉ thì rời nhóm. Website vẫn tự xác nhận bằng webhook, Telegram là lớp quan sát thêm. Tụi em dùng kiểu phân quyền này vì người bán cần biết tiền về, nhưng không có lý do gì phải nhìn toàn bộ số dư.

Ai đang chạy nhiều web cũng không cần trộn hết vào một luồng. Một web bán hàng, một trang thu học phí và một trang gia hạn dịch vụ có thể dùng các VA khác nhau, webhook khác nhau, vẫn đối chiếu trên một dashboard. Vì vậy, tích hợp cổng thanh toán vào website nên bắt đầu bằng sơ đồ tài khoản và người nhận tin, đừng bắt đầu bằng việc dán code.

Bảo mật bắt đầu từ OTP, 2FA và chữ ký webhook

MONA Pay không yêu cầu mật khẩu ngân hàng. Khi nối ACB, ngân hàng gửi hai lượt OTP về số điện thoại đã đăng ký; lượt đầu xác thực tạo tài khoản ảo, lượt sau đăng ký nhận thông báo giao dịch. Tiền của khách đi thẳng vào tài khoản đứng tên anh chị, MONA Pay đọc tín hiệu báo có để gửi tiếp cho website. Cấu trúc này giảm hẳn phần quyền mà một hệ thống bên ngoài phải nắm.

Thiết lập HMAC SHA256 bảo vệ webhook thanh toán website
Wizard tự sinh secret HMAC, giúp người mới không dùng một chuỗi quá ngắn hoặc dễ đoán.

Phía website, mỗi webhook mang hai header là X-Mona-SignatureX-Mona-Timestamp. Web tính HMAC-SHA256 trên mốc thời gian cộng raw body, so sánh bằng hàm an toàn thời gian, rồi từ chối gói lệch quá 5 phút để chặn phát lại. Sau đó web lưu transaction_code dưới dạng khóa không trùng, nên một giao dịch gửi lại ba lần vẫn chỉ hoàn tất một đơn.

Đây là phần tụi em không khuyên bỏ cho nhanh. Nếu endpoint nhận bất kỳ JSON nào rồi tin rằng “đã có 50.000.000đ”, người ngoài đoán được URL là đủ tạo đơn giả đã thanh toán. HMAC xác minh đúng bên gửi, timestamp giới hạn thời gian dùng lại gói cũ, còn mã giao dịch ngăn xử lý lặp. Ba lớp, ba việc.

Cam kết tiền khách chuyển không đi qua MONA Pay
Cam kết sản phẩm ghi rõ giới hạn truy cập dữ liệu và nguyên tắc tiền không đi qua MONA Pay.

Tài khoản dashboard nên bật 2FA TOTP; bản tụi em kiểm ngày 03/09/2026 cấp 10 mã dự phòng sau khi xác nhận mã đầu tiên. Anh chị có thể đọc thêm cách hoạt động của xác thực hai lớp, giữ một bản sao lưu dữ liệu và cài plugin backup WordPress trước khi sửa luồng thanh toán. Tích hợp cổng thanh toán vào website an toàn là câu chuyện của cả tài khoản, webhook và khả năng khôi phục web, chứ không dừng ở một nút quét QR.

Năm lỗi thường gặp khi web tự xác nhận chuyển khoản

Vướng là ở web, không phải ở ngân hàng. Tụi em thường mở Dashboard, vào Webhooks, chọn mục Lịch sử gửi rồi đọc ba cột đầu: mã HTTP, thời gian phản hồi và nhãn lỗi. Nếu dashboard đã có giao dịch mà không có dòng gửi, kiểm phạm vi VA của webhook; nếu có dòng gửi, sửa theo nhãn. Đi theo dấu, khỏi đoán.

Bước nhập địa chỉ webhook của website WordPress
URL webhook phải là địa chỉ HTTPS cuối cùng, không đi qua chuyển hướng.
Dấu hiệu Nguyên nhân hay gặp Cách xử lý
HTTP_3XX URL thiếu HTTPS, sai www hoặc bị chuyển hướng Dán URL đích cuối, không để 301 hoặc 302
TIMEOUT Web xử lý email, kho, hóa đơn rồi mới phản hồi Kiểm chữ ký, trả 200 trong 10 giây, xử lý phần nặng sau
401 sai chữ ký Code ký lại JSON sau khi parse Đọc raw body, dùng đúng secret và X-Mona-Timestamp
Đơn hoàn tất hai lần Chưa đặt khóa chống trùng Lưu transaction_code UNIQUE trước khi cập nhật đơn
Có tiền nhưng đơn vẫn chờ Sai mã đơn, thiếu tiền, webhook nghe nhầm VA Giữ giao dịch để đối chiếu tay, sửa quy tắc rồi gửi lại
Chọn payload JSON để website xác nhận thanh toán
Payload JSON phải được đọc nguyên bản trước khi kiểm chữ ký HMAC.

Website chạy trên máy chủ yếu dễ dính timeout vào giờ cao điểm. Nếu shop đã lớn, chuyển từ shared hosting sang Cloud VPS hoặc đọc trước bài VPS là gì để hiểu phần tài nguyên mình đang thuê. Dù máy khỏe hay yếu, quy tắc vẫn giữ: trả HTTP 200, 201 hoặc 202 trong 10 giây, không trả 204, rồi đưa việc gửi email và trừ kho sang hàng đợi xử lý.

Đừng lấy việc web lỗi làm lý do xác nhận tay mãi. MONA Pay lưu giao dịch và lịch sử gửi, nên sau khi sửa endpoint, anh chị bấm gửi lại đúng payload cũ; transaction_code giữ nguyên để web nhận ra giao dịch đã xử lý. Tích hợp cổng thanh toán vào website có cơ chế đối chiếu và gửi lại mới đủ sức chạy thật. Còn log là còn đường sửa.

AI agent nối MONA Pay mà không cầm mật khẩu ngân hàng

Với website có đội kỹ thuật hoặc chủ shop đang dùng Claude Code, Codex hay Cursor, phần tích hợp cổng thanh toán vào website còn một đường ngắn hơn. Vào Dashboard, mở API Keys, bấm Tạo key; màn hình hiện sẵn lệnh claude mcp add monapay -e MONAPAY_CLIENT_ID=… -e MONAPAY_CLIENT_SECRET=… -- npx -y monapay-mcp. MCP bản 0.3.0 có 22 công cụ để agent đọc gói, tạo webhook, tạo QR, tra giao dịch và đi luồng nối ngân hàng; anh chị dán vào terminal, không cần chép cả bộ tài liệu vào khung chat.

Tài liệu tích hợp cổng thanh toán dành cho lập trình viên
Tài liệu có bản máy đọc và đặc tả API để agent dựng đúng endpoint, header và luồng thử.

Agent đổi client_id với client_secret ra token bằng POST /api/v1/oauth/token, sau đó tự dựng endpoint, đăng ký webhook và kiểm log. Khi tới bước ngân hàng, agent hỏi số tài khoản cùng số điện thoại, chủ tài khoản nhận OTP rồi dán OTP vào cuộc trò chuyện; agent gọi lần lượt bốn công cụ của luồng liên kết và thông báo. Mật khẩu ngân hàng không xuất hiện trong quy trình. Giữ ranh giới đó.

Trước khi chuyển tiền thật, agent gọi POST /api/v1/sandbox/transactions với một số tiền thử, chẳng hạn 10.000đ và nội dung DH10234 test sandbox. MONA Pay ghi giao dịch giả, bắn webhook có chữ ký và tin Telegram như luồng thật, nhưng không tính vào hạn mức gói. Nếu chưa nối ngân hàng, endpoint trả 422 để agent quay lại xin OTP. Đây là bài kiểm tra rất đáng làm khi tích hợp cổng thanh toán vào website đã chạm code riêng.

Tụi em thích AI agent ở phần dựng, đọc log và lặp lại bài test; phần bí mật ngân hàng vẫn nằm với con người. Anh chị không cần cho agent username, mật khẩu hay quyền nhìn số dư. Key lộ thì thu hồi key, OTP sai thì ngân hàng từ chối, webhook giả thì HMAC chặn; phân quyền rõ sẽ nhẹ đầu hơn việc cấm máy làm tất cả.

Từ khóa học đến tiền trọ, nguyên lý khớp tiền vẫn giữ nguyên

WordPress và WooCommerce chỉ là hai điểm bắt đầu dễ thấy, còn shop 150 đơn mỗi tháng là ví dụ gần. Một website quản lý học trực tuyến dùng VA theo học viên hoặc mã ghi danh, web đặt lịch dùng mã cuộc hẹn, hệ thống cho thuê dùng mã phòng, còn SaaS dùng mã khách hàng và kỳ thanh toán. Sau báo có, mỗi hệ thống làm một việc khác nhau: mở khóa học, giữ lịch, ghi nhận tiền trọ hoặc gia hạn tài khoản. Tín hiệu đầu vào vẫn là khoản tiền đã nhận.

Mô hình Dấu để khớp tiền Việc website tự làm sau báo có Link đọc thêm
Shop WooCommerce Mã đơn hoặc VA theo đơn Đổi trạng thái, gửi email, chuyển kho đóng gói Cổng WooCommerce
Khóa học Mã học viên, mã khóa Mở quyền học, ghi nhận học phí Nền tảng khóa học
Đặt lịch Mã cuộc hẹn Giữ khung giờ, gửi xác nhận Cổng WordPress
Thuê trọ VA theo phòng hoặc người thuê Ghi kỳ tiền, báo chủ nhà Mô hình SaaS
Hosting và tên miền Mã hóa đơn gia hạn Đóng hóa đơn, cộng hạn dịch vụ Gia hạn tên miền

Một chủ nhà chỉ cần bấm vào tin Telegram vẫn nhận được lợi ích, dù chưa có web; một trung tâm 300 học viên cần dashboard, mã định danh và quy tắc mở quyền chặt hơn. Một SaaS thu định kỳ phải kiểm kỳ thanh toán trước khi gia hạn, rồi lưu mã giao dịch để lần gửi lại không cộng hai lần. MONA tư vấn theo việc thật, không ép mọi mô hình mang cùng một bộ cấu hình.

Nếu website đang nằm trên tên miền mới, anh chị nên hiểu tên miền là gì và đặt lịch gia hạn trước khi mở webhook ra production. Tên miền hết hạn làm DNS ngừng phân giải, MONA Pay sẽ ghi nhãn lỗi DNS và web không nhận được tin. Tích hợp cổng thanh toán vào website chạy ổn khi cả tên miền, SSL, hosting, plugin và endpoint đều còn được bảo trì. Đường tiền không đứng riêng.

Câu hỏi thường gặp về cổng thanh toán website

Màn hình bật xác thực hai lớp cho MONA Pay
Dashboard phát 10 mã dự phòng sau khi chủ tài khoản xác nhận TOTP thành công.

Website WordPress không dùng WooCommerce có tích hợp cổng thanh toán vào website được không?

Có. MONA Pay chỉ cần một endpoint HTTPS để gửi webhook; endpoint trả HTTP 200 trong 10 giây, sau đó code WordPress phát sự kiện cho plugin khóa học, thành viên, đặt lịch hoặc form thu phí đang dùng. Anh chị không bán hàng bằng WooCommerce vẫn tích hợp cổng thanh toán vào website được, chỉ cần định nghĩa rõ mã nào đại diện cho người trả và website phải làm gì sau khi tiền vào.

Tiền có nằm trong MONA Pay trước khi về ngân hàng không?

Không. Khách chuyển thẳng vào tài khoản ngân hàng đứng tên anh chị. MONA Pay nhận thông báo giao dịch rồi gửi tiếp cho dashboard, Telegram và website; vì vậy không có bước rút tiền từ MONA Pay. Sao kê ngân hàng vẫn là sổ gốc để đối chiếu.

Website lỗi đúng lúc khách chuyển thì có mất giao dịch không?

Giao dịch vẫn nằm trong dashboard; payload cũ lệch quá 5 phút bị từ chối ở lớp chữ ký thời gian, còn MONA Pay vẫn ghi từng lần gửi với mã HTTP, thời gian phản hồi và nhãn lỗi để anh chị mở lịch sử rồi gửi lại khi website hoạt động. Endpoint phải chống trùng bằng transaction_code, nhờ vậy gửi lại không làm đơn được thanh toán hai lần.

Gói Miễn phí có bị cắt webhook hoặc Telegram không?

Không. Gói 0đ có đủ VA, VietQR, webhook, Telegram, API và dashboard cho 500 lần nhận tiền mỗi tháng. Tháng đầu vượt hạn mức vẫn được báo đủ; từ tháng sau, nếu chưa nâng gói, phần vượt vẫn được ghi trong dashboard nhưng không gửi webhook hoặc Telegram cho tới khi nâng. Khách MONA được miễn phí hoàn toàn.

Tụi em vẫn khuyên bật 2FA, cất key ngoài mã nguồn và kiểm lại quyền của người quản trị WordPress mỗi quý. Nếu một tài khoản không còn làm shop, thu hồi quyền ngay. Tích hợp cổng thanh toán vào website càng ít người chạm vào bí mật thì càng dễ quản lý.

Đưa khâu xác nhận tiền ra khỏi ca trực của shop

Một website bán hàng tốt phải hoàn thành phần việc sau khi khách bấm chuyển, kể cả lúc 11 giờ đêm: nhận báo có, khớp đúng đơn, đổi trạng thái và để lại dấu vết cho kế toán. Tụi em đã dùng luồng này cho tiền hosting, tên miền và phần mềm của MONA từ 2022 trước khi mở thành MONA Pay ngày 29/08/2026. Anh chị chưa cần thay toàn bộ cách bán hàng trong một ngày. Bắt đầu bằng một đơn.

Trình tự tích hợp cổng thanh toán vào website gọn là đăng ký, tạo key, nối ngân hàng bằng OTP, cài plugin rồi chạy bốn ca test: đúng tiền, thiếu tiền, sai nội dung và gửi lại webhook. Nhóm bán hàng có thể nhận thêm tin qua Telegram báo biến động số dư; phía web tự cập nhật bằng webhook. Nếu anh chị đang dùng hạ tầng MONA, đội tụi em kiểm luôn hosting, SSL và endpoint trong cùng lượt bàn giao.

Khách chuyển lúc khuya, đơn vẫn phải tự chạy

Shop 150 đơn mỗi tháng đã nằm gọn trong gói 0đ. Anh chị làm web, phần mềm hoặc hosting tại MONA còn được miễn phí hoàn toàn, nên bước còn lại chỉ là chạy một đơn thử cho đúng rồi đưa việc dò sao kê ra khỏi ca trực.

Mở MONA Pay và nối website Gọi 1900 636 648

Đã sẵn sàng để khách chuyển khoản xong, website tự biết và tự xác nhận? Anh chị có thể tích hợp cổng thanh toán vào website từ gói Miễn phí 500 khoản mỗi tháng, hoặc gọi 1900 636 648 để tụi em kiểm luồng WordPress và WooCommerce đang chạy. Một đơn thử đúng hôm nay sẽ cho anh chị câu trả lời rõ hơn cả tuần tiếp tục dò tay.

Bài viết liên quan

Tích hợp cổng thanh toán vào website giúp đơn tự xác nhận
03 Tháng Chín, 2026
Tích hợp cổng thanh toán vào website: 4 bước tự nhận tiền
Tụi em thấy khách mua hosting ở MONA Host phần lớn làm web bán hàng, câu lặp đi lặp lại sau khi web chạy là: “Khách chuyển khoản xong, làm sao website biết để tự xác nhận đơn?” Từ năm 2022, tụi em đã dùng chính luồng này để hóa đơn hosting tự đóng khi...
Đăng ký và duy trì tên miền edu.vn từ 10/2/2026
09 Tháng Ba, 2026
Thông báo thay đổi điều kiện đăng ký và duy trì tên miền “.edu.vn” kể từ ngày 10/02/2026
Kính gửi: Quý khách hàng, Căn cứ Thông tư số 48/2025/TT-BKHCN do Bộ Khoa học và Công nghệ ban hành ngày 25/12/2025, có hiệu lực thi hành từ ngày 10/02/2026, quy định về quản lý và sử dụng tài nguyên Internet tại Việt Nam (bao gồm tên miền “.vn”, địa chỉ IP, ASN), MONA Host...

Võ Nguyên Thoại

Phần mềm xem video tốt nhất
10 Tháng Bảy, 2025
Top 10+ phần mềm xem video, xem phim tốt nhất
Ngày nay, xem phim hay video trực tuyến trên laptop và smartphone đã trở thành thói quen giải trí quen thuộc của nhiều người. Tuy nhiên, để tận hưởng trọn vẹn chất lượng hình ảnh và âm thanh, việc lựa chọn một phần mềm xem video tốt nhất là yếu tố không thể thiếu. Trong...

Võ Nguyên Thoại

Các nội dung video phổ biến
09 Tháng Bảy, 2025
Nội dung video là gì? Các nội dung video phổ biến nhất
Nội dung video hiện đang là xu hướng marketing được nhiều doanh nghiệp ưa chuộng nhờ khả năng thu hút và gây ấn tượng với khách hàng một cách hiệu quả. Với sự phát triển mạnh mẽ của các nền tảng số, nội dung video không chỉ dễ dàng thu hút sự chú ý mà...

Võ Nguyên Thoại

Cách xây dựng video
08 Tháng Bảy, 2025
Cách xây dựng video chuyên nghiệp cho người mới bắt đầu
Bạn đang ấp ủ ý tưởng về những thước phim chất lượng, muốn tự tay kể câu chuyện của mình qua video, nhưng lại băn khoăn không biết bắt đầu từ đâu? Lĩnh vực làm phim, dựng clip có vẻ phức tạp, nhưng thực ra, nó hoàn toàn nằm trong tầm tay nếu bạn nắm...

Võ Nguyên Thoại

Cách làm video bài giảng elearning
07 Tháng Bảy, 2025
Cách làm video bài giảng Elearning, giáo án điện tử chuyên nghiệp
Theo Devin Peck (eLearning Industry), học trực tuyến giúp người học tiết kiệm từ 40% đến 60% thời gian so với phương pháp truyền thống, đồng thời cho phép tiếp thu gấp 5 lần lượng kiến thức trong cùng một khoảng thời gian. Những con số này cho thấy Elearning không còn là lựa chọn...

Võ Nguyên Thoại

04 Tháng Bảy, 2025
Top 6 ứng dụng tải video về điện thoại miễn phí, tốt nhất
Xem video offline một trong những thói quen phổ biến của người dùng trong thời đại công nghệ số hiện nay. Sử dụng smartphone đôi lúc gặp tình trạng kết nối internet không ổn định hoặc muốn tiết kiệm dung lượng 5G khi thưởng thức video yêu thích. Vì vậy, để đảm bảo trải nghiệm...

Võ Nguyên Thoại

Video là gì xu hướng phát triển video
03 Tháng Bảy, 2025
Video là gì? Xu hướng phát triển của video hiện nay
Chỉ với vài phút lướt TikTok, Facebook hay Youtube, bạn đã bắt gặp hàng loạt video viral. Không thể phủ nhận, video đang chiếm lĩnh mọi nền tảng nội dung và trở thành “vũ khí” truyền thông, bán hàng cũng như xây dựng thương hiệu riêng hiệu quả. Nhưng bạn đã thật sự hiểu video...

Võ Nguyên Thoại

Cách tải video Youtube về máy tính, điện thoại
02 Tháng Bảy, 2025
Cách tải video Youtube về máy tính, điện thoại nhanh nhất
YouTube là nền tảng video trực tuyến hàng đầu hiện nay, nơi người dùng có thể dễ dàng tiếp cận hàng triệu nội dung phong phú. Thế nhưng, không phải lúc nào cũng có kết nối internet ổn định để xem trực tuyến, đặc biệt là với các video quan trọng cần xem lại nhiều...

Võ Nguyên Thoại

26 Tháng Sáu, 2025
Top 10 cách tải video từ trang web không cho download hiệu quả
Có những lúc bạn bắt gặp một video hay trên mạng và muốn lưu lại để xem sau hoặc sử dụng cho mục đích cá nhân. Tuy nhiên, website đó không cho phép tải video trực tiếp này về máy, đặc biệt là các trang có nội dung bản quyền hoặc trả phí. Điều này...

Võ Nguyên Thoại

cách lách bản quyền video Youtube nhanh chóng
25 Tháng Sáu, 2025
Hướng dẫn cách lách bản quyền video Youtube hiệu quả
YouTube nền tảng chia sẻ video lớn nhất thế giới với hàng tỷ người dùng hoạt động mỗi ngày, là nơi lý tưởng để các nhà sáng tạo nội dung phát triển kênh và xây dựng thương hiệu cá nhân. Tuy nhiên, vấn đề vi phạm bản quyền luôn là một rào cản lớn, khiến...

Võ Nguyên Thoại

cách nhận biết video có bản quyền trên Youtube
24 Tháng Sáu, 2025
Hướng dẫn cách nhận biết video có bản quyền trên Youtube
Bạn đang muốn đăng tải nội dung lên YouTube nhưng lo lắng dính bản quyền? Vi phạm bản quyền không chỉ khiến video bị gỡ mà còn ảnh hưởng đến uy tín kênh và doanh thu. Vì vậy, việc check bản quyền video YouTube trước khi đăng là cực kỳ quan trọng. Trong bài viết...

Võ Nguyên Thoại

Nhận các thông báo mới từ MONA.Host?

Đăng ký để nhận các bài nghiên cứu, blog, thông tin mới nhất từ chúng tôi

    Email
    Họ tên