TCONNECT
GIẢI PHÁP API

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ì.

Lớp học sáng sủa thu học phí tự động qua API Quét QR · ghi nhận tức thì
🎒 Học phí kỳ🍼 Mầm non📚 Luyện thi · dạy thêm🎓 Dạy nghề · gói khóa
Tóm tắt nhanh

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.

Bài toán

Đầ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.
Lớp học — thu học phí đầu kỳ

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ỳ.

Áp dụng cho

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 thuCách thuHệ 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 đónQR theo khoảnKhớp đúng em, đóng đúng khoản
Gói luyện thi · khóa họcQR trả trướcKích hoạt khóa, ghi nhận số buổi
Đồng phục · sự kiệnQR theo đơnGhi nhận bán hàng theo học sinh
undefined🎒 Trường

Trường & trung tâm

Học phí theo kỳ, mỗi em một mã thu.

Tiền về → đóng kỳ
undefined🍼 Mầm non

Mầm non

Học phí, bán trú, ăn uống theo tháng.

Tiền về → ghi nhận tháng
undefined📚 Luyện thi

Luyệ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
undefined🎓 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ọc
Luồng hoạt động

Từ lúc phụ huynh quét tới lúc ghi nhận

1

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.

2

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.

3

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 thuVí dụ order_idÝ nghĩa
Học phíHS2026-K10A-HP-T08HS lớp 10A, học phí tháng 8/2026
Bán trúHS2026-K10A-BANTRU-T08Tiền bán trú tháng 8
Gói luyện thiGOI-LUYENTHI-2026Gói luyện thi trả trước 2026
Đồng phụcDONGPHUC-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.

Trường & trung tâm được gì

Đến kỳ là thu · tiền về là khớp

Hết nhắc thu thủ công — mỗi em một mã thu định danh.
Không dò sao kê — tiền về tự khớp đúng em, đúng kỳ.
Biết ngay em nào đã đóng, em nào còn nợ.
Phụ huynh đóng 24/7 qua app ngân hàng bất kỳ (VietQR).
Tiền về thẳng tài khoản trường, không giữ hộ.
Tích hợp một lần vào phần mềm quản lý trường.
Câu hỏi thường gặp

Giải đáp nhanh cho trường & trung tâm

? Phụ huynh có cần cài app riêng không?
Không. Phụ huynh quét QR bằng app ngân hàng bất kỳ (VietQR) hoặc chuyển vào tài khoản định danh — không cần cài app riêng.
? Tiền có đi qua trung gian giữ hộ không?
Không. Tiền về thẳng tài khoản ngân hàng của trường; TCONNECT chỉ ghi nhận và báo có.
? Nếu hai phụ huynh chuyển cùng số tiền thì có khớp nhầm không?
Không, vì việc khớp dựa trên tài khoản định danh (VA) hoặc mã đơn order_id, không dựa trên số tiền hay cú pháp ghi chú.
? Tích hợp mất bao lâu?
Với sandbox và file đặc tả API sẵn có, phần thu tiền cơ bản (kết nối, tạo QR, nhận báo có) thường xong trong vài ngày làm việc.