TCONNECT
GIẢI PHÁP API

Thu tiền tự động cho spa, salon,
nail, gym, massage

Đặt cọc giữ lịch chống no-show, thu tại quầy tức thì, bán gói & thẻ trả trước, thu membership định kỳ — mỗi giao dịch tự khớp đúng khách, tiền về thẳng tài khoản tiệm.

Không gian spa · salon hiện đại thu tiền qua API Đặt cọc QR · giữ lịch tức thì
💆 Spa & massage💅 Nail & salon🏋️ Gym membership🎟️ Gói & thẻ
Tóm tắt nhanh

Tiệm chăm sóc cá nhân thu tiền theo nhiều kiểu — đặt cọc giữ lịch, thu tại quầy, bán gói/thẻ trả trước, thu membership định kỳ. Cùng một giải pháp API thanh toán: mỗi khoản gắn mã đơn (order_id) hoặc VA theo khách, nên tiền về tự khớp đúng khách và về thẳng tài khoản của tiệm.

Bài toán

No-show, gói trả trước và membership — quản tay dễ rối

Khách hẹn rồi không đến (no-show) làm trống khung giờ đẹp; gói trả trước và membership định kỳ thì khó theo dõi ai còn buổi, ai tới hạn.

  • 1No-show — khách hẹn miệng rồi không tới, thợ ngồi không, mất doanh thu.
  • 2Chuyển khoản kèm nội dung — chủ tiệm dò sao kê xem ai đã cọc/đã trả.
  • 3Gói & thẻ trả trước — không rõ khách còn mấy buổi, dễ tính nhầm.
  • 4Membership định kỳ — cuối kỳ không biết ai đã đóng, ai còn nợ.
Quầy lễ tân spa salon

Gốc rễ là khâu cọc 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 khách + việc thu, để cọc về là giữ lịch, tiền gói về là kích hoạt buổi.

Áp dụng cho

Một giải pháp API — mọi kiểu thu của tiệm

Mỗi khoản gắn mã đơn (order_id) hoặc VA theo khách, nên tiền về tự khớp đúng khách — đúng việc thu, không cần dò nội dung chuyển khoản.

Tình huốngCách thuHệ thống tự làm khi tiền về
Đặt cọc giữ lịchQR cọc khi đặt hẹnGiữ khung giờ, chống no-show
Thu tại quầyQR động khi khách xong dịch vụĐóng hóa đơn, xuất biên nhận
Gói & thẻ trả trướcQR trả trướcKích hoạt gói, ghi nhận số buổi
Membership định kỳVA / QR mỗi kỳGhi nhận đã đóng kỳ, gia hạn
undefined💆 Spa

Spa & massage

Đặt cọc giữ lịch, thu tại quầy, bán gói.

Cọc về → giữ lịch
undefined💅 Nail

Nail & salon

Thu theo dịch vụ, bán thẻ trả trước.

Tiền về → đóng hóa đơn
undefined🏋️ Gym

Gym & membership

Thu membership định kỳ, gia hạn tự động.

Tiền về → ghi nhận kỳ
undefined🎟️ Gói

Gói & thẻ trả trước

Bán gói buổi, hệ thống trừ dần.

Tiền về → kích hoạt gói
Luồng hoạt động

Từ lúc khách quét tới lúc giữ lịch / đóng hóa đơn

1

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

Phần mềm của tiệm lấy khóa truy cập TCONNECT API — cài đặt một lần, sandbox rồi production.

2

Sinh QR cho mỗi khoản

Đặt cọc, thu tại quầy, bán gói hay membership đều dùng một API tạo QR, chỉ khác số tiền và mã đơn.

3

Tiền về tự khớp

TCONNECT báo có tự động (IPN). Nhờ mã đơn, hệ thống giữ lịch, đóng hóa đơn, kích hoạt gói hoặc ghi nhận membership.

// order_id định danh cho khoản thu này (tối đa 36 ký tự)
const payload = {
  req_id: "req-KH1207-DATCOC-1930", order_id: "KH1207-DATCOC-1930",
  va: "VA100023312", bincode: "970454", amount: 100000,
}; // 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 — gắn đúng khách

Tình huốngVí dụ order_idÝ nghĩa
Cọc giữ lịchKH1207-DATCOC-1930Khách 1207, cọc giữ khung 19:30
Thu tại quầyKH1207-QUAY-20260816Hóa đơn tại quầy ngày 16/08
Gói trả trướcGOI-MASSAGE-10B-2026Gói massage 10 buổi 2026
MembershipMEMBER-GYM-2026T08Phí membership gym tháng 8/2026

Khi khách trả, TCONNECT báo có tự động về phần mềm của tiệm (cơ chế IPN). Nhờ order_id, hệ thống tự giữ lịch, đóng hóa đơn, kích hoạt gói hoặc ghi nhận membership — 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 chi nhánh — gộp về một dashboard

Vì mỗi khoản có VA/order_id định danh, doanh thu tự gộp về đúng chi nhánh. Chủ tiệm xem ngay khách nào còn buổi, membership nào tới hạn, doanh thu từng dịch vụ — 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.

Chủ tiệm được gì

Cọc là giữ lịch · tiền về là xong

Chống no-show — khách phải cọc VietQR mới giữ được lịch.
Không dò sao kê — cọc/thu tự khớp đúng khách.
Gói & thẻ rõ ràng — biết ngay còn mấy buổi.
Membership định kỳ — biết ai đã đóng, ai còn nợ.
Tiền về thẳng tài khoản tiệm, không giữ hộ.
Tích hợp một lần vào phần mềm tiệm đang dùng.
Câu hỏi thường gặp

Giải đáp nhanh cho chủ tiệm

? Khách có cần cài app riêng để cọc hoặc thanh toán không?
Không. Khách 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.
? Đặt cọc online có phức tạp để tích hợp không?
Không. Đặt cọc chỉ là một QR động số tiền nhỏ, dùng đúng một API tạo QR như thu tại quầy, chỉ khác số tiền và mã đơn. Việc xác nhận giữ lịch xử lý ở bước báo có (IPN).
? 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 hoặc order_id, không dựa trên số tiền hay nội dung ghi chú.
? Gói trả trước có bị TCONNECT giữ tiền rồi trừ dần không?
Không. Tiền gói về thẳng tài khoản của tiệm ngay khi khách trả; số buổi còn lại do phần mềm của tiệm quản lý, TCONNECT chỉ ghi nhận và báo có.
? 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 thường xong trong vài ngày làm việc; thêm gói và membership là logic phía phần mềm tiệm.