Thu tiền thuê & phí dịch vụ
cho bất động sản cho thuê

Nhiều phòng, nhiều khoản — thu và đối soát bằng tay rất mệt

Mỗi đầu tháng chủ nhà/BQL phải nhắc từng khách, nhận chuyển khoản rồi dò sao kê xem phòng nào đã đóng tiền thuê, ai còn thiếu điện nước.

• 1Nhắc thu thủ công — nhắn từng khách mỗi kỳ, dễ sót, dễ trễ.
• 2Chuyển khoản kèm nội dung — dò sao kê xem phòng nào đã đóng, khoản gì.
• 3Nhiều khoản mỗi phòng — thuê, điện, nước, gửi xe… cộng tay dễ nhầm.
• 4Cọc & hoàn cọc — theo dõi tay khi nhận và khi trả nhà.

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 cấp mỗi phòng một mã thu định danh, để tiền về là tự khớp đúng phòng — đúng kỳ.

Từ lúc khách quét tới lúc ghi nhận đúng phòng

// order_id định danh cho khoản thu này (tối đa 36 ký tự)
const payload = {
  req_id: "req-CH-A1203-THUE-2026T08", order_id: "CH-A1203-THUE-2026T08",
  va: "VA100023312", bincode: "970454", amount: 8500000,
}; // 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 phòng một mã định danh — khớp không nhầm

Khi khách trả, TCONNECT báo có tự động về phần mềm quản lý (cơ chế IPN). Nhờ order_id/VA, hệ thống ghi nhận đã đóng đúng phòng — đúng kỳ và cập nhật công nợ — chủ nhà/BQL 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 toà, nhiều phòng — gộp về một dashboard

Vì mỗi phòng có VA/order_id định danh, công nợ tự gộp về đúng phòng — đúng toà. Chủ nhà/BQL xem ngay phòng nào đã đóng, phòng 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.