Thu phí dịch vụ chuyên môn (luật, kế toán, agency, tư vấn) bằng API thanh toán

Tóm tắt nhanh: Văn phòng luật, kế toán, agency và tư vấn thu phí theo bốn kiểu — tạm ứng trước khi làm, thu theo mốc dự án, phí duy trì định kỳ (retainer), và quyết toán cuối kỳ. Cùng một giải pháp API thanh toán xử lý cả bốn: mỗi khoản gắn một mã đơn định danh (order_id) hoặc tài khoản định danh (VA), nên tiền về tự khớp đúng khách — đúng dự án — đúng đợt, bảng công nợ cập nhật tức thì và tiền về thẳng tài khoản ngân hàng của văn phòng.

Vì sao thu phí dịch vụ chuyên môn hay bị trễ và khó theo dõi?

Khác với bán lẻ thu một lần tại quầy, dịch vụ chuyên môn thu tiền theo tiến độ công việc và thường là giá trị lớn, nhiều đợt: tạm ứng khi ký hợp đồng, thu tiếp khi qua mốc, phí duy trì hàng tháng, rồi quyết toán. Mỗi khách một dự án, mỗi dự án nhiều lần thu.

Cách làm phổ biến dễ vỡ ở nhiều chỗ:

• Làm trước, thu sau — bắt tay vào việc rồi mới đòi tạm ứng, dễ rơi vào cảnh "làm không công" khi khách chậm trả.
• Chuyển khoản kèm nội dung cho từng đợt → kế toán dò sao kê thủ công, ghép tiền về với đúng khách và đúng dự án.
• Retainer nhiều khách đóng rải rác trong tháng → cuối kỳ không biết ai đã đóng, ai còn thiếu.
• Công nợ trên Excel cập nhật trễ → báo cáo phải thu (AR) và tuổi nợ luôn lệch thực tế.

Gốc rễ không nằm ở khách, mà ở chỗ khâu thu tiền và ghép công nợ vẫn làm tay. Đây chính là phần mà một giải pháp API thanh toán tự động hóa gọn gàng — cho cả bốn kiểu thu trên.

Có mấy cách thu phí cho văn phòng dịch vụ chuyên môn?

Điểm chung: mỗi khoản thu gắn một mã đơn định danh (order_id) hoặc tài khoản định danh (VA), nên tiền về tự khớp đúng khách — đúng dự án — đúng đợt, không cần dò nội dung chuyển khoản.

"Một giải pháp API, mọi đợt thu" — tạm ứng, milestone, retainer, quyết toán đều đi qua cùng một bộ API; tiền về thẳng tài khoản ngân hàng của văn phòng, TConnect không giữ tiền.

Luồng hoạt động

[Phần mềm quản lý văn phòng / cổng khách hàng]
        │  tạo khoản thu (order_id, amount, client_id, dự án + đợt)
        ▼
POST /openapi/v1/transaction/qr/generate   →  [TConnect Payment API]
        │  trả về qr_content + ảnh QR (hoặc link thanh toán)
        ▼
[Khách quét QR / chuyển vào VA / bấm link]
        │
        ▼
[Tiền về tài khoản ngân hàng của văn phòng]
        │
        ▼
IPN Callback  →  [Backend phần mềm]  →  Ghi nhận đợt + cập nhật công nợ

Toàn bộ đặc tả API xem tại docs.tconnect.vn (có sẵn file đặc tả để nạp cho AI/vibe code).

Triển khai như thế nào

Về mặt kỹ thuật, cả bốn kiểu thu chỉ xoay quanh ba việc: kết nối một lần, sinh QR cho mỗi khoản, và nhận báo có tự động. Phần lớn công sức nằm ở quy trình vận hành phía văn phòng, không phải ở code.

1. Kết nối một lần

Phần mềm quản lý của văn phòng đăng nhập vào TConnect Payment API để lấy khóa truy cập (access_token), lưu lại dùng nhiều giờ. Đây là việc cài đặt một lần. Bắt đầu trên sandbox https://sme-open-api-sandbox.tconnect.vn, khi chạy thật đổi sang https://sme-open-api.tconnect.vn.

2. Sinh QR cho mỗi khoản — cùng một lệnh

Dù là tạm ứng, milestone, retainer hay quyết toán, hệ thống đều gọi đúng một API để tạo QR động, chỉ khác số tiền (amount) và mã đơn (order_id):

// Tạo QR động cho một khoản thu bất kỳ (tạm ứng / mốc / retainer / quyết toán)
const { data } = await createQR({
  amount,             // số tiền cần thu
  order_id: orderId,  // định danh: khách + dự án + đợt, để tự khớp
});
// data.qr_content       → mã VietQR để hiển thị trên hóa đơn / cổng khách hàng
// data.image_png_base64 → ảnh QR gửi kèm email / Zalo

Quy ước order_id là chỗ quyết định "tiền về khớp vào đâu". Đặt theo khách + dự án + đợt để tra cứu và lên báo cáo công nợ dễ:

3. Tiền về — hệ thống tự khớp, không ai phải dò

Khi khách trả tiền, TConnect báo có tự động về phần mềm của văn phòng (cơ chế IPN — Instant Payment Notification). Nhờ order_id, hệ thống biết ngay đây là khoản gì và tự làm đúng việc:

• Tạm ứng về → kích hoạt dự án, đội ngũ bắt đầu triển khai với ràng buộc rõ ràng.
• Tiền milestone về → mở đợt tiếp theo, cập nhật tiến độ thu theo dự án.
• Phí retainer về → ghi nhận đã đóng kỳ, cập nhật hạn dịch vụ của khách.
• Quyết toán về → đóng hóa đơn, xuất hóa đơn điện tử, chốt công nợ.

Toàn bộ khâu này chạy ngầm 24/7 — kế toán không phải mở app ngân hàng dò sao kê và ghép tay từng đợt như trước. Việc dựng phần "báo có" là chuyện kỹ thuật của bên tích hợp; nó chỉ cần làm đúng ba nguyên tắc: xác thực nguồn gọi, không ghi nhận trùng một giao dịch, và phản hồi nhanh. Chi tiết xem Webhook/IPN: xử lý callback an toàn.

Công nợ & dòng tiền: nhìn một màn hình, không sót khoản nào

Vì mọi khoản thu đều tự khớp về đúng khách và dự án, bảng phải thu (AR) và tuổi nợ luôn phản ánh đúng thực tế theo thời gian thực. Từ đó hệ thống có thể tự nhắc thu qua Zalo/SMS khi tới hạn hoặc quá hạn, thay vì để kế toán rà tay. Dòng tiền theo tiến độ dự án trở nên dễ dự báo: biết đợt nào đã về, đợt nào sắp tới, khách nào đang chậm.

Xuất hóa đơn điện tử (tùy chọn)

Sau khi ghi nhận thanh toán, bạ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 cho khách — đúng Nghị định 123/2020 & 70/2025. Phần này là bước bổ sung: nghiệp vụ thu tiền tự động ở trên đã chạy độc lập. Tham khảo API Hóa đơn điện tử.

Văn phòng và phần mềm quản lý được gì?

• Không làm không công — tạm ứng thu trước, có ràng buộc rồi mới triển khai.
• Dòng tiền theo tiến độ — thu đúng đợt, không dồn rủi ro về cuối dự án.
• Công nợ đúng thực tế — mỗi khoản tự khớp khách + dự án, AR và tuổi nợ cập nhật tức thì.
• Nhắc thu tự động qua Zalo/SMS, thu đúng hạn hơn.
• Tiền về thẳng tài khoản của văn phòng, không qua trung gian giữ hộ.
• Với đơn vị làm phần mềm cho văn phòng luật / kế toán / agency / tư vấn: tích hợp một lần bộ API thanh toán, thêm ngay các tính năng "thu tạm ứng", "thu theo mốc", "retainer định kỳ" cho toàn bộ khách hàng.

Câu hỏi thường gặp

Khách hàng doanh nghiệp trả bằng chuyển khoản hoặc thẻ được không? Được. Cùng một bộ API hỗ trợ QR VietQR, thẻ nội địa và quốc tế; tiền về thẳng tài khoản ngân hàng của văn phòng, đối soát tức thì.

Thu theo mốc dự án (milestone) có cần tích hợp riêng không? Không. Mỗi mốc chỉ là một QR động với số tiền và mã đơn khác nhau, dùng đúng một API tạo QR. Việc mở đợt tiếp theo xử lý ở bước báo có.

Phí duy trì định kỳ (retainer) hàng tháng theo dõi thế nào? Cấp cho mỗi khách một tài khoản định danh (VA) hoặc sinh QR mỗi kỳ. Khi tiền về, hệ thống ghi nhận đã đóng kỳ đó và cập nhật công nợ, biết ngay khách nào còn thiếu.

Nếu hai khách 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 VA/order_id định danh, không dựa trên số tiền hay nội dung ghi chú.

Có xuất được hóa đơn điện tử hợp lệ sau khi thu không? Có. Sau khi ghi nhận thanh toán, hệ thống gọi tiếp API hóa đơn điện tử để phát hành hóa đơn hợp lệ theo Nghị định 123/2020 và 70/2025.

Bắt đầu

1. Đọc tài liệu và tải file đặc tả API: docs.tconnect.vn/docs/intro
2. Thử trên sandbox: https://sme-open-api-sandbox.tconnect.vn
3. Liên hệ để lấy tài khoản kết nối & hỗ trợ tích hợp: tconnect.vn — Zalo 0375 927 102

Đặc biệt: TConnect hỗ trợ tích hợp miễn phí vào phần mềm quản lý văn phòng luật / kế toán / agency / tư vấn mà bạn đang dùng — không phải đổi phần mềm.