Thu tiền dịch vụ tận nơi
& sửa chữa bằng API

Thu tiền mặt tại nhà — khó đối soát, dễ nhầm đơn & thợ

Thợ đi làm tận nơi, thu tiền mặt rồi cuối ngày nộp về; công ty khó biết đơn nào đã thu, thợ nào cầm tiền, khách nào còn nợ.

• 1Tiền mặt qua tay thợ — cuối ngày nộp về, khó đối soát, dễ thất thoát.
• 2Chuyển khoản kèm nội dung — dò sao kê xem tiền của đơn nào, thợ nào.
• 3Khách đặt rồi hủy — cử thợ tới nơi mới biết, tốn công di chuyển.
• 4Gói bảo trì định kỳ — khó theo dõi kỳ nào đã đóng, lịch bảo trì kế tiếp.

Gốc rễ là khâu thu và ghi nhận làm tay. Một giải pháp API thanh toán cho thợ sinh QR ngay trên điện thoại theo đúng đơn, để tiền về là tự khớp đúng đơn — đúng thợ.

Từ lúc khách quét tới lúc đóng đơn

// order_id định danh cho khoản thu này (tối đa 36 ký tự)
const payload = {
  req_id: "req-DH2026-0817-DIENLANH-T05", order_id: "DH2026-0817-DIENLANH-T05",
  va: "VA100023312", bincode: "970454", amount: 350000,
}; // 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 đơn một mã định danh — gắn đúng đơn & thợ

Khi khách quét QR trả tại nhà, TCONNECT báo có tự động về phần mềm (cơ chế IPN). Nhờ order_id, hệ thống ghi nhận đúng đơn, đúng thợ, đóng đơn và cập nhật công nợ — không ai 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 thợ, nhiều đội — gộp về một dashboard

Vì mỗi đơn có order_id định danh theo đơn và thợ, doanh thu tự gộp về đúng thợ — đúng đội. Công ty xem ngay đơn nào đã thu, thợ nào thu bao nhiêu, gói bảo trì nào tới 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.