VECTIQ
← Toàn bộ dự án
Giáo dụcĐANG VẬN HÀNH

ECMS Tài Chính & VietQR

Học phí, hóa đơn, ví và gói thuê bao, kèm mã thanh toán VietQR và webhook đối soát từ chối chạy nếu không có chữ ký

ECMS Tài Chính & VietQR

Tổng quan

Học phí là chỗ một trung tâm giáo dục thật sự mất tiền, và gần như luôn theo cùng một kiểu: phụ huynh chuyển khoản, không ai khớp giao dịch đó với học sinh nào, ba tuần sau danh sách lớp và sao kê ngân hàng không khớp nhau.

Module tài chính gánh biểu phí, hóa đơn, ví theo từng học sinh, giao dịch và gói thuê bao, rồi khép vòng bằng VietQR - mã thanh toán mang theo mã tham chiếu định danh hóa đơn, và webhook của ngân hàng tự ghi khoản thu ngược về đúng hóa đơn đó.

Webhook là chỗ đáng nghiêm khắc: không cấu hình VIETQR_WEBHOOK_SECRET thì nó bị từ chối thẳng chứ không xử lý mù, vì một endpoint thanh toán ai cũng POST được là cách đánh dấu hóa đơn đã trả mà không mất đồng nào.

Tính năng chính

Biểu phí và quy tắc học phí theo từng lớp
Hóa đơn có thanh toán một phần và lịch sử điều chỉnh
Ví theo từng học sinh và sổ cái giao dịch
Sinh mã VietQR mang theo mã tham chiếu hóa đơn
Webhook đối soát có ký, từ chối khi thiếu chữ ký
Gói thuê bao cho các chương trình học định kỳ
Dự báo doanh thu và tỉ lệ rời bỏ từ giao dịch thật
Nhắc học phí còn nợ tới phụ huynh

Công nghệ sử dụng

NestJS · backendPostgreSQL · databaseVietQR · otherRedis · database

Giải pháp