Thu tiền cho máy tự động
& điểm self-service bằng API

Máy đứng ngoài trời, không người trực
— thu tiền & đối soát kiểu cũ dễ vỡ

Điểm chung của mọi máy self-service là không có thu ngân. Khách tự thao tác, tự trả tiền, và máy phải tự quyết định có mở hay không. Khi thu bằng tiền mặt hoặc chuyển khoản thủ công, hàng loạt vấn đề phát sinh:

• 1Tiền mặt trong máy — phải đi gom, dễ kẹt, dễ mất, khó đối soát cuối ngày.
• 2Chuyển khoản kèm nội dung — chủ trạm dò sao kê thủ công; máy không tự biết để mở.
• 3Nhiều máy, nhiều trạm — cuối tháng cộng doanh thu bằng tay, không biết máy nào hỏng.
• 4Khách chờ lâu — trả xong vẫn phải gọi nhờ mở máy ở nơi đáng lẽ nhanh nhất.

Gốc rễ không nằm ở khách, mà ở chỗ khâu thu tiền và lệnh mở máy chưa nối với nhau. Đây chính là phần mà một giải pháp API thanh toán tự động hóa gọn gàng: tiền về là máy mở, không cần con người ở giữa.

Từ lúc khách quét tới lúc máy mở

// order_id định danh cho phiên này (tối đa 36 ký tự)
const payload = {
  req_id: "req-EV-Q7-TRU04-1930", order_id: "EV-Q7-TRU04-20260816-1930",
  va: "VA100023312", bincode: "970454", amount: 45000,
}; // 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 phiên 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 của trạm (cơ chế IPN — Instant Payment Notification). Nhờ order_id, hệ thống biết ngay đây là phiên nào và tự làm đúng việc: tiền sạc về thì mở cổng sạc; tiền bơm về thì chạy bơm đúng số lít; tiền cọc pin về thì nhả pin rồi khi trả pin tự hoàn cọc/trừ tiền; tiền món về thì nhả hàng. Toàn bộ chạy ngầm 24/7 — chủ trạm không phải ngồi canh tin nhắn ngân hàng. Phần "báo có" chỉ cần đúng ba nguyên tắc: xác thực nguồn gọi, không ghi nhận trùng, và phản hồi nhanh (dưới vài giây). Chi tiết: Webhook/IPN xử lý callback an toàn.

Nhiều máy, nhiều trạm — gộp về một dashboard

Vì mỗi máy và mỗi phiên có VA/order_id định danh, doanh thu tự gộp về đúng máy — đúng trạm. Chủ trạm xem ngay: máy nào chạy tốt, máy nào ế, máy nào im lặng bất thường (có thể đang hỏng hoặc mất kết nối), trạm nào cần thêm trụ. Không còn cảnh cuối tháng đi gom tiền mặt từng máy rồ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 và mở máy tự động ở trên đã chạy độc lập. Tham khảo API Hóa đơn điện tử.