Thu học phí tự động
cho trường & trung tâm dạy học
Trường, mầm non, trung tâm dạy học, luyện thi, dạy nghề — mỗi học sinh một mã QR định danh; phụ huynh quét VietQR là xong, hệ thống tự khớp đúng học sinh + kỳ + khoản, ghi nhận tức thì.
Quét QR · ghi nhận tức thìTrường học và trung tâm thu nhiều khoản — học phí kỳ, bán trú, xe đưa đón, gói luyện thi, đồng phục, sự kiện. Cùng một giải pháp API thanh toán: mỗi khoản gắn mã đơn (order_id) hoặc tài khoản định danh (VA) theo học sinh và kỳ, nên tiền về tự khớp đúng học sinh — đúng kỳ, hết dò sao kê và tiền về thẳng tài khoản của trường.
Đầu kỳ thu học phí — nhắc từng phụ huynh, dò sao kê mệt
Mỗi đầu kỳ, kế toán trường phải nhắc từng phụ huynh, nhận chuyển khoản rồi dò sao kê xem em nào đã đóng, khoản nào còn thiếu.
- 1Nhắc thu thủ công — nhắn từng phụ huynh mỗi kỳ, dễ sót, dễ trễ.
- 2Chuyển khoản kèm nội dung — dò sao kê xem em nào đã đóng, khoản gì.
- 3Trùng số tiền — nhiều em cùng mức học phí, khớp tay dễ nhầm hồ sơ.
- 4Nhiều khoản mỗi em — học phí, bán trú, xe, đồng phục… cộng tay dễ sai.

Gốc rễ là khâu nhắc thu và ghi nhận làm tay. Một giải pháp API thanh toán gắn mỗi khoản với học sinh + kỳ, để tiền về là tự khớp đúng em — đúng kỳ.
Một giải pháp API — mọi khoản của trường
Mỗi khoản gắn mã đơn (order_id) hoặc VA theo học sinh và kỳ, nên tiền về tự khớp đúng học sinh — đúng kỳ — đúng khoản.
| Khoản thu | Cách thu | Hệ thống tự làm khi tiền về |
|---|---|---|
| Học phí theo kỳ | VA/QR theo học sinh mỗi kỳ | Ghi nhận đã đóng kỳ, xuất biên lai |
| Bán trú · xe đưa đón | QR theo khoản | Khớp đúng em, đóng đúng khoản |
| Gói luyện thi · khóa học | QR trả trước | Kích hoạt khóa, ghi nhận số buổi |
| Đồng phục · sự kiện | QR theo đơn | Ghi nhận bán hàng theo học sinh |
🎒 TrườngTrường & trung tâm
Học phí theo kỳ, mỗi em một mã thu.
Tiền về → đóng kỳ
🍼 Mầm nonMầm non
Học phí, bán trú, ăn uống theo tháng.
Tiền về → ghi nhận tháng
📚 Luyện thiLuyện thi · dạy thêm
Gói buổi trả trước, hệ thống trừ dần.
Tiền về → kích hoạt gói
🎓 Dạy nghềDạy nghề · gói khóa
Khóa học trả trước hoặc trả góp theo kỳ.
Tiền về → mở khóa họcTừ lúc phụ huynh quét tới lúc ghi nhận
Xác thực & kết nối
Phần mềm quản lý trường lấy khóa truy cập TCONNECT API — cài đặt một lần, sandbox rồi production.
Sinh QR học phí
Mỗi thông báo học phí tạo QR động gắn mã học sinh · kỳ · khoản; gửi qua app, Zalo hoặc email.
Báo có & ghi nhận
TCONNECT báo có tự động (IPN). Nhờ mã đơn, hệ thống khớp đúng học sinh + kỳ, cập nhật đã đóng, xuất biên lai.
// order_id định danh cho khoản thu này (tối đa 36 ký tự) const payload = { req_id: "req-HS2026-K10A-HP-T08", order_id: "HS2026-K10A-HP-T08", va: "VA100023312", bincode: "970454", amount: 2500000, }; // amount 0/bỏ trống = QR tĩnh; > 0 = QR động // Mã hoá AES-256-CBC (hex) rồi gọi API tạo QR const res = await fetch("https://sme-open-api-sandbox.tconnect.vn/openapi/v1/transaction/qr/generate", { method: "POST", headers: { "partner-code": partnerCode, "x-service-code": serviceCode, // lấy từ API Get Services Authorization: `Bearer ${accessToken}`, "Content-Type": "application/json", }, body: JSON.stringify({ data: encryptAES256(payload) }), });
Mỗi khoản một mã định danh — khớp không nhầm học sinh
| Khoản thu | Ví dụ order_id | Ý nghĩa |
|---|---|---|
| Học phí | HS2026-K10A-HP-T08 | HS lớp 10A, học phí tháng 8/2026 |
| Bán trú | HS2026-K10A-BANTRU-T08 | Tiền bán trú tháng 8 |
| Gói luyện thi | GOI-LUYENTHI-2026 | Gói luyện thi trả trước 2026 |
| Đồng phục | DONGPHUC-HS2026-088 | Đơn đồng phục của học sinh |
Khi phụ huynh trả tiền, TCONNECT báo có tự động về phần mềm (cơ chế IPN). Nhờ order_id, hệ thống khớp đúng học sinh + kỳ và cập nhật đã đóng, xuất biên lai — kế toán không phải dò sao kê. Phần báo có chỉ cần: xác thực nguồn gọi, không ghi trùng, phản hồi nhanh.
Nhiều lớp, nhiều cơ sở — gộp về một dashboard
Vì mỗi khoản có VA/order_id định danh, công nợ tự gộp về đúng lớp — đúng cơ sở. Nhà trường xem ngay em nào đã đóng, em nào còn nợ, tỉ lệ thu từng kỳ — không cộng sổ tay.
Xuất hóa đơn điện tử (tùy chọn)
Sau khi ghi nhận thanh toán, có thể gọi tiếp API hóa đơn điện tử của TCONNECT để tự phát hành hóa đơn/biên nhận cho khách — đúng Nghị định 123/2020 & 70/2025. Đây là bước bổ sung; nghiệp vụ thu tiền tự động ở trên đã chạy độc lập.
Đến kỳ là thu · tiền về là khớp
Giải đáp nhanh cho trường & trung tâm
order_id, không dựa trên số tiền hay cú pháp ghi chú.