Thu tiền đặt sân thể thao
bằng API thanh toán

Giữ sân bằng lời hứa — trùng giờ, bùng kèo, dò sao kê

Khách nhắn đặt sân, hứa chuyển cọc rồi im; chủ sâ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.

• 1Giữ giờ bằng lời hứa — khách đặt miệng rồi không đến (bùng kèo), sân trống.
• 2Hai người đặt trùng một khung giờ vì chủ sân xác nhận tay không kịp.
• 3Chuyển khoản kèm nội dung — dò sao kê xem ai đã cọc, cho sân nào, giờ nào.
• 4Đội cố định hàng tuần đóng rải rác — cuối tháng không rõ đội nào đã đóng.

Gốc rễ là khâu cọc và xác nhận làm tay. Một giải pháp API thanh toán gắn mỗi khoản với sân + khung giờ, để cọc về là tự khóa đúng slot.

Từ lúc khách quét tới lúc khóa slot

// order_id định danh cho khoản thu này (tối đa 36 ký tự)
const payload = {
  req_id: "req-S3-20260817-1900-COC", order_id: "S3-20260817-1900-COC",
  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 lượt một mã định danh — khớp đúng sân & khung giờ

Khi khách quét cọc, 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 và khóa đúng khung giờ của đúng sân, gửi Zalo báo khách đã giữ sân — chủ sân không phải ngồi canh tin nhắn ngân hàng. 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 sân, nhiều cụm — gộp về một dashboard

Vì mỗi lượt có order_id định danh theo sân và khung giờ, doanh thu tự gộp về đúng sân — đúng cụm. Chủ sân xem tỉ lệ lấp đầy theo sân và khung giờ để biết giờ nào cần khuyến mãi, giờ nào luôn kín.

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.