Biến động số dư báo qua Telegram: shop bỏ loa, đơn tự khớp

Khách đến MONA làm web bán hàng thường hỏi tụi em: “Có cần mua cái loa báo tiền không, hay để điện thoại báo là đủ?” Câu hỏi nhỏ, nhưng chạm đúng việc khiến nhiều shop mệt mỗi ngày. Biến động số dư phải tới được cả người trực ca lẫn phần mềm xử lý đơn, thay vì dừng ở một tiếng kêu cạnh quầy. MONA Pay gửi thông báo tiền vào Telegram cho đúng nhóm, lưu lại trên dashboard và chuyển cùng dữ liệu sang webhook để đơn tự khớp. Bài này chỉ rõ lúc giữ loa, lúc bỏ loa, cách cài qua 3 lần bấm và phép tính phí cho shop 300 đơn mỗi tháng.

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 đi thẳng vào tài khoản ngân hàng đứng tên anh chị; MONA Pay nhận bản tin giao dịch để báo lại, không giữ tiền và không cần mật khẩu ngân hàng. Tụi em kiểm lại phạm vi này ngày 03/09/2026. Phạm vi rất rõ.

Shop cần nghe một khoản tiền hay cần cả ca xử lý được?

Câu hỏi tụi em nghe ở nhiều dự án website bán hàng thường bắt đầu bằng cái loa, nhưng việc thật lại nằm sau tiếng báo: ai biết khoản tiền vừa vào, người ca sau tìm lại ở đâu, kế toán đối soát thế nào và website có tự đổi đơn sang đã thanh toán hay vẫn chờ tay người. Một tiếng “ting” giải quyết được khoảnh khắc trước mặt. Nó chưa giải quyết cả ca bán hàng.

Hình dung một shop có 2 ca, chủ không đứng quầy và nhân viên kho ở phòng khác. Khách chuyển 650.000 đồng, loa đọc số tiền cho thu ngân nghe; chủ ở nhà không nghe, kho không nghe, kế toán cuối ngày cũng không có sổ từ chiếc loa ấy. Nếu cùng lúc có 2 khách chuyển 650.000 đồng, người đứng quầy còn phải nhìn nội dung hoặc mở ứng dụng ngân hàng để đoán khoản nào thuộc đơn nào. Biến động số dư có giá trị khi nó mang theo số tiền, nội dung, thời gian và tài khoản nhận. Bốn trường đó mới giúp ca trực làm tiếp.

Hệ thống MONA Pay đưa biến động số dư đến đúng người
Biến động số dư được MONA Pay đưa cho người và phần mềm trong cùng đường nhận tiền.

Tụi em chốt theo cách rất đời: quầy ồn, đông khách, thu ngân rảnh tay ít thì âm thanh tại chỗ vẫn hữu ích; shop online, nhiều ca hoặc chủ thường đi khỏi cửa hàng thì Telegram mạnh hơn vì cả nhóm nhận cùng một bản tin. Website đã có luồng xử lý đơn thì thêm webhook, đừng giao cho nhân viên một nút “xác nhận đã nhận tiền” rồi hy vọng ai cũng nhớ bấm. Máy làm phần đều đặn. Người xử lý ca lệch.

MONA không bán loa, và tụi em không khuyên anh chị bỏ thiết bị đang giải đúng chuyện nghe tiền tại quầy. Tụi em tách ba nhu cầu: nghe tại chỗ, chia tin cho cả nhóm, tự chạy việc trong phần mềm; mỗi nhu cầu có một kênh đúng hơn trong cách MONA Pay tự động hóa cổng thanh toán.

Biến động số dư nên đi vào loa thông báo chuyển khoản, SMS, Telegram hay webhook

Nhìn vào 4 kênh dưới đây cho một shop 300 đơn mỗi tháng, anh chị sẽ thấy mỗi kênh thắng ở một việc. Loa thắng trong quầy đông và ồn; SMS ngân hàng thắng khi chủ tài khoản cần biết ngay trên số điện thoại đã đăng ký; Telegram thắng khi nhiều người ở nhiều nơi phải nhận cùng tin; webhook thắng khi website hoặc phần mềm phải tự làm tiếp. Chọn sai kênh mới gây mệt. Chọn đúng thì chúng đứng cạnh nhau được.

Kênh nhận biến động số dưAi thấyCó sổ tìm lại khôngPhí phía MONA PayViệc hợp nhất
Biến động số dư qua loa tại quầyNgười đứng gần 1 quầyKhông, âm thanh phát rồi hếtKhông liên quan; hỏi ngân hàng cung cấp loaQuầy ồn, cần nghe số tiền tức thì
Biến động số dư qua SMS hoặc báo đẩy ngân hàngNgười giữ số điện thoại hoặc thiết bịCó lịch sử tin, nhưng khó chia theo ca và đơnKhông liên quanChủ tài khoản theo dõi cá nhân
Biến động số dư qua TelegramCả nhóm, hoặc đúng topic của caCó lịch sử tìm theo nội dung và thời gian0 đồng trong gói 500 khoản mỗi thángChủ, bán hàng, kế toán cùng biết
Biến động số dư qua webhookWebsite, phần mềm bán hàng, khoCó log gửi, mã giao dịch và dashboard0 đồng trong gói 500 khoản mỗi thángTự khớp đơn, gạch nợ, mở quyền

Bảng này cũng giải thích vì sao một bài về các hình thức thanh toán online dễ làm người đọc rối nếu gom mọi thứ thành “báo có”. SMS và Telegram cùng báo cho người, song quyền xem và cách chia người nhận khác nhau. Webhook đi theo hướng khác: bản tin JSON có cấu trúc được gửi sang máy chủ, để quy tắc của shop đọc mã đơn, so số tiền rồi đổi trạng thái. Tới đây là hết chuyện nghe.

Sổ giao dịch MONA Pay có bộ lọc và tìm kiếm
Sổ biến động số dư giữ dữ liệu mà tiếng loa và một tin SMS riêng lẻ không làm được.

MONA Pay giữ bản ghi giao dịch trên dashboard dù điện thoại của nhân viên mất mạng. Trang lịch sử có bộ lọc từ ngày, đến ngày, tài khoản VA, loại giao dịch, ô tìm theo nội dung hoặc mã, cùng nút xuất CSV ở gói có quyền xuất. Cả nhóm nhận tin ở Telegram, kế toán vẫn có một sổ gốc để rà lại; biến động số dư không mất chỉ vì một thiết bị đang ngoại tuyến.

Có một ranh giới tụi em luôn nói rõ với khách MONA: Telegram là kênh báo người, webhook là kênh báo phần mềm. Nếu shop chỉ cần 2 người là chủ và kế toán cùng nhìn thấy tiền vào, cấu hình Telegram là đủ, chưa cần viết mã. Nếu đơn phải tự sang trạng thái “đã thanh toán” lúc 11 giờ đêm, hãy làm webhook ngay từ đầu và dùng Telegram như kênh quan sát song song. Đừng bắt nhóm chat làm việc của hệ thống.

MONA chia nhóm Telegram theo ca và VA từ năm 2022

Tụi em tự xây hệ thống nhận biến động ACB từ năm 2022 để thu tiền cho chính MONA và các phần mềm giao khách, rồi mới đóng gói thành MONA Pay. Nhóm Telegram kế toán nhận khoản vào để người phụ trách biết; phần mềm phía sau đọc đúng dữ liệu để khớp dịch vụ, đơn hoặc kỳ thu. Hơn 6.000 khách hàng mới của MONA đã dùng hệ thống nhận tiền này trước mốc mở public ngày 29/08/2026. Tụi em dùng trước thật lâu.

Cách chia nhóm trong nhà MONA cho tụi em một bài học nhỏ: một nhóm “mọi giao dịch” dành cho người kiểm soát khác hẳn nhóm vận hành theo ca. Người quản lý cần nhìn toàn bộ, còn nhân viên chỉ cần khoản liên quan tới phần việc của họ; dồn tất cả vào một nhóm lớn khiến tin tiền vào chen giữa công việc khác, rồi ca sau lại kéo lên tìm. Vì vậy MONA Pay cho một tài khoản tạo nhiều cấu hình Telegram, gắn từng cấu hình với một VA hoặc để trống VA nhằm nhận toàn bộ.

Dashboard MONA Pay gom các bước nhận tiền của shop
Dashboard cho thấy biến động số dư đi cùng Telegram, VA và sổ giao dịch.

VA là số tài khoản ảo dùng để nhận diện nguồn thu, tiền chuyển vào VA vẫn về tài khoản ngân hàng thật của anh chị. Shop có 3 cửa hàng thì cấp mỗi cửa hàng một VA; nhóm chủ nghe cả 3, nhóm cửa hàng A chỉ nghe VA A, còn topic “Ca tối” nhận đúng phần của ca. Anh chị muốn hiểu sâu hơn có thể đọc bài tài khoản ngân hàng ảo là gì. Nguyên tắc vẫn rất gọn: quyền xem đi theo công việc.

Ngày 03/09/2026, tụi em đăng ký lại như một chủ tiệm hoa mới, tạo key, đi hết wizard webhook 5 bước, nối Telegram và bật 2FA. Có đoạn kiểm thử hơi buồn cười: đặt tên cấu hình xong, tụi em vẫn cố tình bắn tin thử trước khi sang bước kế, vì thiếu dấu trừ trong group_id là bot im ngay. Chi tiết nhỏ này giúp hướng dẫn bên dưới bớt một vòng mò lỗi. Đã bấm thật mới nhớ.

Quan điểm đó đi cùng cách MONA 2.0 làm sản phẩm: bài hướng dẫn mọc ra từ việc tụi em đã vận hành. Với biến động số dư, dấu vết rất rõ: chia theo VA, giữ nhóm tổng cho chủ, topic theo ca, bắn thử trước khi bật thật. Bốn quyết định nhỏ này giảm chuyện hỏi lại mỗi khi đổi nhân viên hoặc mở thêm điểm bán.

Ba bước tạo bot Telegram báo có cho shop

Phần cấu hình người không rành kỹ thuật vẫn tự làm được. Trên my.monapay.vn, anh chị mở mục Telegram và đi qua wizard 4 bước; phần quyết định nằm ở 3 thao tác đầu là thêm bot, dán ID nhóm rồi gửi thử. Bước sau chỉ chọn nguồn tiền và mẫu tin. Cứ làm đúng thứ tự.

  1. Thêm bot vào nhóm: mở nhóm Telegram cần nhận tin, vào phần thêm thành viên, tìm đúng @monapay_telebot rồi thêm bot. Nhóm chỉ dành cho chủ và kế toán thì nhận mọi tài khoản; nhóm cửa hàng chọn riêng VA ở bước nguồn cấp.
  2. Dán group_id và topic_id: group_id của nhóm lớn thường bắt đầu bằng -100. Nếu nhóm đã bật chủ đề, dán thêm topic_id để biến động số dư rơi đúng topic “Tiền vào” hoặc “Ca tối”, tránh lẫn vào chủ đề General.
  3. Bắn thử trước khi lưu: bấm “Bắn thử tin nhắn Test”. Tin xác nhận kết nối kiểm bot và group_id; tin giao dịch giả lập kiểm luôn mẫu nội dung, số tiền, thời gian và nguồn nhận.
Màn hình cấu hình nhóm và chủ đề Telegram trên MONA Pay
Wizard biến động số dư gom group_id, topic_id và phép gửi thử trên một màn hình.

Lỗi phổ biến nằm ở dãy ID chứ không nằm ở bot. Thiếu dấu trừ, thiếu phần 100 đầu hoặc lấy ID của topic thay cho ID nhóm đều làm tin thử không tới; bot bị đưa khỏi nhóm cũng cho kết quả giống vậy. Tụi em luôn bấm thử ngay tại bước 1, thấy tin mới đi tiếp. Một phút ở đây đỡ mười phút mò.

Ở bước nguồn cấp, anh chị chọn mọi tài khoản hoặc đúng 1 VA. Shop nhiều chi nhánh thường dùng một cấu hình tổng cho chủ, sau đó mỗi chi nhánh có thêm một cấu hình gắn với VA của mình; nhóm có chủ đề thì topic_id tách tiếp theo ca hoặc theo quầy. Thông báo tiền vào Telegram vì thế không bắt cả công ty nhìn thấy cùng một thứ; người nào làm việc nào nhận đúng phần đó.

Mẫu tin mặc định đã có tên ngân hàng, số tài khoản nhận, loại tiền vào, số tiền, thời điểm, nội dung và số dư sau giao dịch nếu ngân hàng gửi kèm. Anh chị muốn nhân viên nhìn nhanh thì rút còn 2 dòng, dùng đúng biến {{amount}}{{transaction_content}}. Bản tụi em kiểm ngày 03/09/2026 chấp nhận các thẻ Telegram cơ bản như <b>, <i><code>. Đừng nhét cả sổ kế toán vào một tin.

✅ +{{amount}}đ vào {{account_number}}
{{transaction_content}} · {{transaction_date}}

Nếu anh chị từng liên kết website WordPress với Telegram, điểm khác ở đây là nguồn tin đi từ bản ghi giao dịch của ngân hàng, không lấy từ một hành động biên tập trên website. Cấu hình xong, anh chị bấm gửi thử giao dịch giả lập theo đúng mẫu. Thấy số tiền, nội dung và thời gian hiện trong nhóm là phần báo người đã hoàn tất.

Telegram báo người, webhook tự khớp đơn cho phần mềm

Khách chuyển xong, nhóm Telegram thấy biến động số dư trong vài giây là một nửa công việc. Nửa còn lại nằm ở đơn hàng: website phải tìm đúng mã, so đúng số tiền, đổi trạng thái, đẩy phiếu sang kho và gửi xác nhận mà không chờ nhân viên mở nhóm rồi bấm tay. Tụi em dùng webhook cho phần đó. Máy nhận thì máy làm tiếp.

Một webhook là yêu cầu HTTP POST mà MONA Pay gửi tới URL của website khi có giao dịch. Bản tin mang số tiền, nội dung, thời gian, transaction_code, tài khoản nhận, ngân hàng và loại giao dịch; phía shop xác minh chữ ký rồi trả HTTP 200 trong 10 giây. Tài liệu giải thích API của IBM mô tả API như bộ quy tắc để các phần mềm trao đổi dữ liệu và chức năng. Ở ca này, quy tắc ấy biến một tin tiền vào thành lệnh cập nhật đơn.

Wizard webhook nhập địa chỉ nhận thông báo tiền vào
Webhook biến động số dư dùng URL HTTPS để phần mềm nhận đúng bản tin giao dịch.

Wizard webhook có 5 bước: nhập tên và URL, chọn nguồn tài khoản, chọn bảo mật, chọn định dạng payload, kiểm lại rồi lưu. MONA khuyên dùng HMAC-SHA256; MONA Pay đặt dấu thời gian ở X-Mona-Timestamp và chữ ký ở X-Mona-Signature. Website ký lại đúng raw body, từ chối tin lệch quá 5 phút, so sánh bằng hàm an toàn rồi trả 200 trước khi chạy việc nặng; mã transaction_code phải là khóa UNIQUE để một lần gửi lại không ghi tiền hai lần.

Bước bảo mật webhook bằng HMAC SHA256 trên MONA Pay
HMAC-SHA256 ký từng payload biến động số dư để website phân biệt tin thật và dữ liệu giả.

Phần này nghe kỹ thuật, song chủ shop chỉ cần giữ một tiêu chuẩn vận hành: Telegram báo rồi mà đơn chưa đổi, nhân viên tra dashboard theo mã giao dịch và đưa đơn vào hàng chờ, không tự xác nhận từ ảnh bill. Đội kỹ thuật đọc phần webhook là gì và log gửi để tìm lỗi DNS, SSL, TIMEOUT hoặc HTTP_5XX. Dữ liệu ngân hàng vẫn còn. Đừng giao hàng bằng ảnh chụp.

Tụi em cũng không khuyên lấy nhóm chat làm cơ sở dữ liệu. Telegram cho cả ca nhìn nhanh, tìm lại một khoản và biết ai đang xử lý; dashboard giữ sổ giao dịch; webhook đẩy việc vào đúng phần mềm. Ba lớp này giúp ca sau không phải hỏi ca trước “khách đó chuyển chưa”, và giúp chủ shop không phải ngồi mở khái niệm API mới hiểu chuyện đang chạy. Mỗi lớp nói đúng ngôn ngữ của nó.

Chạy tin Telegram trước, rồi mới viết webhook

Anh chị đã dặn khách ghi đúng nội dung, đã lập nhóm ca, đã giao người dò ứng dụng ngân hàng, vậy mà một tối có 20 đơn thì cả nhóm vẫn hỏi lại từng khoản. Tụi em hiểu công sức đó; hãy nối nhóm Telegram và bắn một tin thử trước, thấy đúng số tiền, nội dung, VA rồi mới giao đội kỹ thuật cho đơn tự khớp. Một bước nhỏ, đo được ngay.

Tạo tài khoản và gửi thử miễn phí Gọi 1900 636 648

Miễn phí chỉ có nghĩa khi tính cả đường tiền

Nói “miễn phí” mà chỉ nhìn giá một phần mềm thì chưa đủ. Shop cần nhìn cả đường tiền: phí theo phần trăm doanh thu, phí cố định mỗi giao dịch, phí duy trì cổng, phí rút và phí đổi tiền nếu bán quốc tế; sau đó mới đặt cạnh chi phí theo số khoản của MONA Pay. Bảng dưới dùng biểu phí chính chủ, ghi rõ ngày. Số nào cũng kiểm lại được.

Đường nhận tiềnPhí công bốGhi chú nguồn
Biến động số dư từ thẻ nội địa NAPAS0,5–0,7% khi nối trực tiếp; 1,09% + 1.818đ mỗi giao dịch khi nối gián tiếpBiểu phí TMĐT VietinBank, hiệu lực 22/04/2026, chưa VAT
Biến động số dư từ Visa/Mastercard trong nước1,818–2,182% + 4.200đ mỗi giao dịchBiểu phí TMĐT VietinBank, hiệu lực 22/04/2026, chưa VAT
Biến động số dư từ thẻ phát hành nước ngoài3,7–3,8% + 4.500đ mỗi giao dịch + 700.000đ mỗi tháng duy trì cổngBiểu phí TMĐT VietinBank, hiệu lực 22/04/2026, chưa VAT
Biến động số dư từ PayPal4,40% + 0,30 USD; rút 60.000đ mỗi lần; đổi tiền 4%Biểu phí merchant PayPal Việt Nam, kiểm ngày 28/05/2026
Biến động số dư từ chuyển khoản qua MONA Pay0% + 0đ ở gói Miễn phí 500 khoản mỗi thángTiền vào thẳng ngân hàng; gói trả phí tính theo số khoản

Hai dòng thẻ lấy từ biểu phí dịch vụ chấp nhận thanh toán thẻ VietinBank; dòng quốc tế lấy từ biểu phí merchant PayPal Việt Nam. Với đường chuyển khoản, Báo Chính phủ dẫn thông tin NAPAS về miễn phí chuyển mạch giao dịch dưới 1 triệu đồng và VietQR 0 đồng. MONA Pay nhận bản tin báo có rồi tính gói theo số khoản, không lấy phần trăm doanh thu. Đó là hai lớp phí khác nhau.

Phép tính cho đúng ngành của bài: một shop có 300 đơn mỗi tháng, giá trị trung bình 600.000 đồng, tổng tiền thu là 180.000.000 đồng. Nếu cả 300 đơn đi qua thẻ Visa/Mastercard phát hành trong nước ở mức thấp 1,818% + 4.200đ, phí trước VAT là 3.272.400đ theo tỷ lệ + 1.260.000đ cố định = 4.532.400đ mỗi tháng. Nếu 300 khoản là chuyển khoản tự báo có, gói Miễn phí của MONA Pay vẫn nằm dưới hạn mức 500 khoản và phí phần mềm là 0đ; chênh lệch ấy trả được nhiều việc hơn một cái loa.

Bảng giá MONA Pay tính theo số khoản tiền vào
Biến động số dư qua MONA Pay được tính theo số khoản, không theo phần trăm tiền bán.
Gói MONA PayGiá mỗi thángKhoản tiền vào mỗi thángGiá trả năm
Miễn phí500
Khởi nghiệp99.000đ2.000990.000đ
Kinh doanh299.000đ10.0002.990.000đ
Doanh nghiệp799.000đ50.0007.990.000đ
Quy mô lớn1.990.000đ300.00019.900.000đ

Giá được tụi em kiểm ngày 03/09/2026 trên bảng giá MONA Pay; trả năm bằng 10 tháng. Giao dịch ở đây là một khoản tiền vào ghi nhận trên mọi tài khoản và VA đã nối, tính theo tháng dương lịch giờ Việt Nam; tiền ra, sandbox và webhook gửi lại không tính. Gói trả phí vượt mức không khóa, phần vượt gom vào hóa đơn cuối tháng theo đơn giá từng gói. Cách tính phải rõ vậy.

Màn hình gói và hóa đơn nâng cấp MONA Pay
Gói biến động số dư được nâng ngay trên dashboard mà không đổi đường tiền của shop.

Khách đang làm web, phần mềm hoặc hosting tại MONA được miễn phí hoàn toàn và không giới hạn giao dịch trong thời gian còn dùng dịch vụ. Gói Miễn phí công khai vẫn có VA, VietQR, webhook, Telegram, API, không giới hạn số webhook và số nhóm; tháng đầu vượt 500 khoản hệ thống vẫn báo đủ, từ tháng kế phần vượt còn trên dashboard nhưng tạm ngừng gửi webhook và Telegram cho tới khi nâng gói. Không mất bản ghi. Anh chị tính theo số đơn thật rồi chọn.

Nhiều ngân hàng trên một dashboard, nhân viên không cầm app

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 4 năm 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. Nghĩa là cấu hình Telegram và webhook nằm trên lớp chung, khi thêm một ngân hàng đã hoạt động thì shop không phải dựng lại quy trình nhận tin từ đầu. Nói nhiều ngân hàng trước để anh chị khỏi hiểu sai rằng hệ thống bị khóa vào một tài khoản.

Với chi nhánh, VA giúp biến động số dư mang sẵn nhãn nguồn. Anh chị nhập số tài khoản nhận gốc, số điện thoại đã đăng ký với ngân hàng, loại khách hàng, prefix và phần định danh tối đa 10 ký tự không dấu; ngân hàng gửi OTP về điện thoại để xác minh 1 lần. MONA Pay không hỏi mật khẩu ứng dụng ngân hàng, không có quyền rút hoặc chuyển tiền. Nhân viên chỉ vào nhóm Telegram của quầy.

Biểu mẫu tạo tài khoản ảo riêng cho cửa hàng
Mỗi VA gắn biến động số dư với một nguồn thu, tiền vẫn về ngân hàng của anh chị.

Quyền trên dashboard cũng cần tách khỏi quyền nhận tin. Chủ tài khoản bật xác thực hai lớp TOTP, quét QR bằng ứng dụng xác thực, nhập mã 6 số rồi cất 10 mã dự phòng; nhân viên bán hàng không cần được chia tài khoản quản trị chỉ để xem tiền vào. Nếu một người nghỉ ca, quản lý đưa người đó khỏi nhóm Telegram, không đổi mật khẩu ngân hàng và không giao lại điện thoại. Ít quyền hơn thì dễ quản.

Thiết lập xác thực hai lớp và mã dự phòng MONA Pay
2FA bảo vệ bảng biến động số dư, nhân viên chỉ nhận tin bằng quyền trong nhóm.

Đội tích hợp tạo API key ở dashboard và lưu client secret ngoài mã nguồn; hướng dẫn về API key của IBM cũng khuyên thu hồi khóa đã lộ thay vì tiếp tục dùng. Client secret chỉ hiện một lần, nên người phụ trách phải cất trong biến môi trường; anh chị đọc thêm 2FA là gì nếu muốn chuẩn hóa quyền đăng nhập cho các hệ thống khác. Mật khẩu ngân hàng không nằm trong luồng này.

Danh sách API key dành cho tích hợp MONA Pay
API key tách quyền đọc biến động số dư khỏi mật khẩu và tài khoản đăng nhập.

AI agent cũng cấu hình được qua MCP 0.4.0 với 34 tools. Từ dashboard, anh chị vào API Keys, bấm Tạo key rồi sao chép nguyên lệnh dưới đây; agent tự đổi client credentials ra token bằng POST /api/v1/oauth/token, hỏi OTP ngay trong khung chat khi nối ngân hàng và thử luồng bằng POST /api/v1/sandbox/transactions. Giao dịch sandbox không tốn tiền và không tính hạn mức. Agent không bao giờ cầm mật khẩu.

claude mcp add monapay -e MONAPAY_CLIENT_ID=client_xxx -e MONAPAY_CLIENT_SECRET=xxx -- npx -y monapay-mcp

POST /api/v1/oauth/token → data.access_token
POST /api/v1/sandbox/transactions → data.transaction_code
Khối lệnh MCP giúp AI agent kết nối MONA Pay
MCP cấu hình luồng biến động số dư mà AI agent không đọc mật khẩu ngân hàng.

Bảng xử lý dưới đây là phần tụi em dùng để khoanh lỗi trước khi gọi kỹ thuật. Biến động số dư vẫn xuất hiện trên dashboard thì đường ngân hàng đã ổn, việc cần soi nằm ở Telegram hoặc webhook; dashboard trống thì kiểm trạng thái nối ngân hàng và OTP nhận thông báo. Đừng sửa mọi thứ cùng lúc. Tách từng chặng mới ra lỗi.

Dấu hiệuChỗ kiểm đầuCách xử lý
Biến động số dư có trên dashboard, Telegram imBot, group_id, topic_id, VA, is_activeThêm lại bot, dán đúng ID, bật cấu hình rồi bắn thử
Biến động số dư rơi vào Generaltopic_idLấy đúng ID chủ đề và lưu lại cấu hình
Biến động số dư tới Telegram, đơn chưa đổiLog webhook, HTTP status, chữ kýKiểm raw body, cửa sổ 5 phút và phản hồi 200 trong 10 giây
Biến động số dư gửi lại làm đơn tăng hai lầntransaction_codeĐặt UNIQUE và bỏ qua mã đã xử lý
Biến động số dư tới lúc điện thoại mất mạngDashboardGiao dịch vẫn nằm trong sổ; kết nối lại để nhận tin mới

Nhà trọ, trung tâm, spa và F&B nhận tiền theo khóa khác nhau

Cùng là biến động số dư, mỗi ngành lại cần một khóa để biết tiền của ai. Shop online dùng mã đơn hoặc VA của đơn; nhà trọ dùng VA của phòng và kỳ tháng; trung tâm dùng VA của học viên; spa dùng mã lịch cọc; F&B dùng mã bàn hoặc hóa đơn. Telegram vẫn báo cho đúng nhóm, còn webhook đọc khóa đó để chạy việc kế; khóa rõ thì khỏi đoán.

Với nhà trọ, một khoản 3.500.000 đồng chỉ có ý nghĩa khi biết đó là phòng nào và tháng nào. Tụi em khuyên gắn một VA ổn định cho từng phòng hoặc từng người thuê, rồi mẫu tin Telegram hiện số tiền, VA và nội dung; phần mềm gạch công nợ sau khi so kỳ thu. Chủ nhà nhìn nhóm tổng, người quản lý dãy trọ nhận topic của khu mình. Biến động số dư lúc này thành một dòng thu có địa chỉ.

Trung tâm 300 học viên gặp bài toán gần giống nhưng nhịp thu dồn theo kỳ. Mỗi học viên có VA hoặc mã học phí, Telegram báo nhóm kế toán để biết tiền đã về, webhook ghi vào hồ sơ và mở quyền học khi số tiền khớp; khoản thiếu được đưa sang danh sách chờ để người kiểm. Anh chị đang vận hành mảng này có thể xem thêm cách phần mềm quản lý thu học phí gom kỳ thu và công nợ. Đừng mở nhầm quyền học.

Màn hình tạo VietQR theo tài khoản ảo và khoản thu
VietQR và VA cho biến động số dư của mỗi ngành một khóa nhận diện rõ ràng.

Spa cần giữ lịch khi tiền cọc vào, nên mã lịch và số tiền là hai điều kiện bắt buộc; F&B lại cần tốc độ ở quầy, nơi loa của ngân hàng và Telegram dùng song song vẫn rất hợp lý. Quán ồn giữ loa để thu ngân nghe, nhóm Telegram để chủ và kế toán thấy, webhook để màn hình bếp hoặc phần mềm bán hàng nhận trạng thái. Bài kinh nghiệm vận hành nhà hàng cho thấy mỗi mắt xích tại quầy đều cần rõ người chịu trách nhiệm; biến động số dư chỉ mở đầu cho chuỗi đó.

Một shop bán hàng đa kênh còn phải tránh khớp nhầm giữa web, mạng xã hội và quầy. Cấp mã đơn thống nhất hoặc VA theo nguồn, sau đó webhook ghi cùng transaction_code vào sổ chung để mỗi khoản chỉ được ghi 1 lần; Telegram giữ vai trò báo ca, không làm nơi nhân viên tự đặt trạng thái. Đọc thêm cách tổ chức bán hàng đa kênh sẽ thấy lý do mã đơn phải đi xuyên mọi nơi. Tụi em ưu tiên khóa nhận diện trước khi nói tới tự động.

NgànhKhóa nhận diện khoản thuNhóm TelegramWebhook làm tiếp
Biến động số dư của shop onlineMã đơn hoặc VA từng đơnChốt đơn, kế toánĐổi trạng thái, đẩy kho
Biến động số dư tiền nhà trọVA phòng + kỳ thángChủ nhà, quản lý khuGạch công nợ, phát biên nhận
Biến động số dư học phí trung tâmVA học viên + kỳ thuKế toán, tư vấn viên phụ tráchGhi học phí, mở quyền học
Biến động số dư tiền cọc spaMã lịch + số tiền cọcLễ tân, quản lý cơ sởGiữ lịch, nhắc khách
Biến động số dư tại F&BMã bàn hoặc hóa đơnThu ngân, kế toánChốt hóa đơn, cập nhật quầy

Đây là chỗ MONA nối báo tiền với tự động hóa doanh nghiệp: tín hiệu ngân hàng sạch đi vào quy tắc của từng ngành, người chỉ xử lý khoản lệch. AI agent giúp cấu hình và kiểm tra, nhưng mã đơn, kỳ thu và mức cọc vẫn do hệ thống kinh doanh của anh chị quyết định. Công nghệ hợp việc nào thì giao đúng việc ấy. Tự động tới gốc mới bền.

Câu hỏi thường gặp về biến động số dư qua Telegram

Bốn câu dưới đây là chỗ chủ shop và kế toán hay dừng lại trước khi nối tài khoản. Tụi em trả lời theo bản hệ thống đã kiểm ngày 03/09/2026, kèm đúng giới hạn đang chạy; anh chị muốn xem từng bước và biến mẫu tin thì mở tài liệu Telegram của MONA Pay. Có log để kiểm.

Tài liệu Telegram webhook và API ngân hàng MONA Pay
Tài liệu biến động số dư là chỗ kiểm mẫu tin, giới hạn và cách gửi lại.

Bot báo biến động số dư có đọc được số dư tài khoản không?

Bot Telegram không đăng nhập ứng dụng ngân hàng và không cầm mật khẩu của anh chị. MONA Pay nhận bản tin giao dịch từ ngân hàng rồi gửi các trường được cấu hình như số tiền, thời gian, nội dung, số tài khoản nhận; biến {{accumulated}} chỉ có dữ liệu khi phía ngân hàng gửi kèm. Nhân viên trong nhóm thấy nội dung tin, không tự mở được dashboard hay tài khoản ngân hàng. Quyền được tách rõ.

Nhóm nhiều chi nhánh chia biến động số dư thế nào?

Mỗi chi nhánh dùng một VA và một cấu hình Telegram riêng, còn nhóm chủ để chế độ nhận mọi tài khoản. Công ty có thể giữ 1 nhóm lớn rồi chia topic theo cơ sở hoặc theo ca, nhập đúng topic_id ở từng cấu hình; tiền của chi nhánh A không cần hiện ở nhóm chi nhánh B. Khi thêm cơ sở thứ 4, anh chị tạo VA và cấu hình mới, không sửa ba nhóm đang chạy. Cách chia này gọn hơn cấp ứng dụng ngân hàng cho từng quản lý.

Biến động số dư tiền ra có gửi thông báo không?

Chưa. Tính tới ngày 03/09/2026, loại giao dịch đang phát qua MONA Pay là tiền vào với type: income; tiền ra chưa báo. Hạn mức gói cũng tính khoản tiền vào, nên giao dịch chi không làm tăng số đã dùng. Khi phạm vi thay đổi, tụi em sẽ ghi tại tài liệu công khai.

Mất mạng thì biến động số dư và giao dịch đi đâu?

Điện thoại thu ngân mất mạng không làm mất biến động số dư đã ghi nhận. Giao dịch vẫn nằm trên dashboard; khi điện thoại nối lại, Telegram đồng bộ lịch sử của nhóm, còn webhook có log để đội kỹ thuật xem trạng thái. Nếu bot bị đưa khỏi nhóm hoặc group_id đổi, sửa cấu hình rồi bấm gửi lại từ giao dịch. Đơn chưa khớp giữ ở hàng chờ, không xác nhận bằng ảnh bill.

Bỏ loa khi đúng việc, giữ loa khi quầy quá ồn

Quan điểm cuối của MONA rất rõ: shop online, nhiều ca và người quản lý thường ở xa thì biến động số dư qua Telegram hữu ích hơn một chiếc loa đứng yên; quầy F&B quá ồn vẫn giữ loa để thu ngân nghe, rồi dùng Telegram cho chủ và kế toán, webhook cho phần mềm. Tụi em không ép một kênh thắng mọi việc; mỗi kênh nhận đúng phần.

Anh chị bắt đầu bằng đường ngắn: tạo tài khoản, nối ngân hàng bằng OTP, thêm @monapay_telebot, dán group_id, chọn VA rồi bắn thử. Thấy tin đúng mẫu thì đi thêm webhook, đặt transaction_code UNIQUE, trả HTTP 200 trong 10 giây và thử sandbox với 10.000đ trước khi chạm tiền thật. Muốn đối chiếu khả năng từng kênh, đọc trang chia sẻ biến động số dư qua Telegram và trang báo tiền vào tại quầy. Chạy nhỏ rồi mở rộng.

Trang cam kết bảo mật dữ liệu và đường tiền MONA Pay
Cam kết biến động số dư chốt giới hạn quyền, dữ liệu và cách bảo vệ đường tiền.

Tụi em đã đi hết luồng này ngày 03/09/2026 với vai chủ tiệm hoa: tạo key, nối Telegram, bật 2FA và đi qua wizard webhook 5 bước. Phần AI agent được giữ ngắn vì người chủ không cần học kỹ thuật, còn đội tích hợp có tài liệu, MCP 0.4.0 và 34 tools để làm. Nếu anh chị muốn nhìn bức nền rộng hơn, bài ứng dụng AI trong doanh nghiệp giải thích cách giao việc lặp cho máy, còn MONA Software là nơi xem năng lực viết phần mềm riêng. Người chịu trách nhiệm vẫn phải rõ.

300 đơn mỗi tháng, đừng trả 4.532.400đ chỉ để biết tiền đã vào

Chủ shop đọc tới đây thường có hai cách. Một là giữ cảnh ca bán hàng hỏi chủ, chủ hỏi kế toán, kế toán mở ứng dụng rồi nhắn lại; hai là dành một buổi nối nhóm Telegram, bắn giao dịch sandbox và để webhook tự khớp. Tụi em cũng là dân vận hành, nên tụi em chọn cách hai từ năm 2022: ít người phải nhớ hơn, mọi khoản vẫn có sổ để quay lại.

Gói Miễn phí đủ 500 khoản mỗi tháng cho shop 300 đơn chạy thật. Khách đang dùng web, phần mềm hoặc hosting của MONA được gán gói miễn phí hoàn toàn; anh chị gọi 1900 636 648, tụi em ngồi cùng tới khi tin thử rơi đúng nhóm và đơn thử đổi đúng trạng thái.

Nhận biến động số dư qua Telegram Gọi 1900 636 648

MONA hoạt động từ năm 2016, đã làm 14.000+ dự án và có 85% khách quay lại; con số ấy có ý nghĩa khi biến động số dư được làm đến nơi: chủ thấy, ca trực thấy, phần mềm khớp, kế toán còn sổ. Anh chị hãy đăng ký dùng thử ngay, chuyển một khoản sandbox rồi nhìn biến động số dư đi hết đường từ ngân hàng tới Telegram và đơn hàng. Cần tụi em kiểm cùng thì gọi 1900 636 648 hoặc viết tới info@themona.global. Đã sẵn sàng để ca sau không hỏi lại ca trước?

MONA có podcast — nghe thay vì đọcCác tập về AI, tự động hoá & SEO cho doanh nghiệp Việt
Nghe ngay
Về tác giả

CEO & Founder · The MONA

Người sáng lập The MONA, xây dựng công ty dịch vụ 200+ nhân sự với 14.000+ dự án đã triển khai. Khánh Hùng chia sẻ tư duy xây hệ thống tự chạy, tự động hoá doanh nghiệp và những bài học triển khai thật phía sau MONA.

Lượt xem 209
Đánh giá bài viết 4,6/5 · 21 đánh giá

Bài viết liên quan

Dịch vụ thiết kế
website chuyên nghiệp

Sở hữu website với giao diện đẹp, độc quyền 100%, bảo hành trọn đời với khả năng
mở rộng tính năng linh hoạt theo sự phát triển doanh nghiệp ngay hôm nay!

Liên hệ Mona

    MONA có riêng một Người "Bạn Thân" cho bạn - Người Account sẽ đồng hành, hỗ trợ, hướng dẫn, đặt đồ ăn cho bạn mãi mãi, từ đây về sau!
    MONA cam kết tuyệt đối không sử dụng thông tin của bạn để bán hoặc SPAM
    Đội MONA tư vấn hệ thống quản lý giáo dục trực tuyến
    Hỏi đáp giáo dục 4.0
    Tạo cuộc hẹn miễn phí với MONA để giải đáp và tư vấn mọi thắc mắc về giải pháp số hoá ngành giáo dục
    Thời lượng cuộc hẹn
    45 Phút
    Ngày và giờ
    Thứ 2, ngày 25 tháng 12, 2023
    [9:30 - 10:15]

      Chọn ngày và giờ
      Khung giờ
      Quay lại
      Hãy cho MONA biết bạn là ai
      0:00