Thu tiền dịch vụ thú cưng
bằng API thanh toán

Đặt cọc miệng, thu tiền tay — dễ bùng lịch, khó đối soát

Dịp lễ khách đặt phòng lưu trú kín; nhân viên vừa trực điện thoại vừa canh tin nhắn ngân hàng để biết ai đã cọc thật, ai chỉ hỏi cho vui.

• 1Giữ phòng bằng lời hứa — khách đặt miệng rồi không đến, phòng trống dịp cao điểm.
• 2Chuyển khoản kèm nội dung — dò sao kê xem ai đã cọc, cho boss nào, dịch vụ gì.
• 3Gói spa/grooming trả trước — không rõ khách còn mấy buổi, dễ tính nhầm.
• 4Nhiều khoản lẫn lộn — khám, tắm, lưu trú, mua đồ… cuối ngày cộng sổ mệt.

Vấn đề nằm ở 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 + boss + dịch vụ, để cọc về là tự giữ phòng, tiền về là tự đóng hóa đơn.

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

// order_id định danh cho khoản thu này (tối đa 36 ký tự)
const payload = {
  req_id: "req-BOSS-MIU-LUUTRU-20260816-3D", order_id: "BOSS-MIU-LUUTRU-20260816-3D",
  va: "VA100023312", bincode: "970454", amount: 600000,
}; // 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 & boss

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

Vì mỗi khoản có VA/order_id định danh, doanh thu tự gộp về đúng cơ sở. Chủ tiệm xem ngay boss nào đang lưu trú, gói nào còn buổi, doanh thu từng dịch vụ — không phải 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.