# 🎯 OneQR - Khái niệm

## 📱 OneQR là gì?

**OneQR** là giải pháp **QR Code thanh toán thống nhất** được phát triển bởi Pay2S. Nó cho phép doanh nghiệp, cửa hàng tạo một mã QR duy nhất để nhận thanh toán từ **tất cả ngân hàng, ví điện tử, và nền tảng thanh toán** mà không cần tạo QR riêng cho từng cổng.

### 🎁 Lợi ích chính

- **Không cần nhập tiền**: Khách scan → Số tiền đã cố định → Xác nhận → Xong
- **Tự động khoá số tiền**: Không thể thanh toán sai số tiền
- **Tức thì xác nhận**: Tiền được ghi nhận ngay lập tức (0-1 giây)
- **Bảo mật cao**: 1 QR = 1 giao dịch, không tái sử dụng
- **Dễ tracking**: Mỗi QR liên kết 1-to-1 với 1 invoice/order
- **Không phụ thuộc ngân hàng**: Tất cả NH, ví điều support
- **Webhook tự động**: Cập nhật hệ thống merchant ngay khi thanh toán

---

## 🔄 Cách hoạt động

```mermaid
graph LR
    A["👤 Khách hàng<br/>Scan QR"] -->|Chọn ngân hàng| B["🏦 Ngân hàng<br/>Vietcombank, ACB, Momo..."]
    B -->|Chuyển tiền| C["💳 OneQR Gateway<br/>Pay2S"]
    C -->|Xác nhận| D["✅ Tài khoản<br/>Cập nhật"]
    D -->|📊 Webhook| E["📈 Dashboard<br/>Xem lịch sử"]
```

### Các bước chi tiết:

1. **Khách hàng quét QR** → App ngân hàng hoặc ví điện tử mở
2. **Chọn ngân hàng** → Vietcombank, Techcombank, Momo, ZaloPay, v.v.
3. **Nhập số tiền & nội dung** → Tùy chọn (nếu QR động)
4. **Xác nhận thanh toán** → Gửi đến Pay2S
5. **Cập nhật tài khoản** → Tiền được ghi nhận ngay
6. **Webhook thông báo** → Hệ thống merchant nhận sự kiện

---

## ✨ Dynamic QR - Nền tảng OneQR

**OneQR hoàn toàn là một hệ thống QR động (Dynamic QR)**, không phải QR tĩnh. Điều này có nghĩa:

- 🔄 **Mã QR thay đổi** theo từng giao dịch
- 💰 **Số tiền cố định** sẵn trong QR
- 🎯 **1-to-1 mapping**: 1 QR = 1 giao dịch
- 📱 **Scan → Thanh toán**: Khách không cần nhập tiền

### 📌 Ví dụ cực kỳ đơn giản:

```
Merchant tạo đơn hàng: 500,000 đ
  ↓
OneQR sinh 1 QR code với số tiền 500k (đã cố định)
  ↓
Khách scan QR
  ↓
App ngân hàng hiển thị: "Thanh toán 500,000 đ cho [Shop]"
  ↓
Khách xác nhận 1 lần → Xong
```

**Lợi ích của Dynamic QR:**
- ✅ Không cần nhập tiền (giảm lỗi)
- ✅ Tự động xác nhận (lập tức)
- ✅ Từ chối tiền sai số (bảo mật)
- ✅ Perfect cho E-commerce, invoice, checkout online

---

## 🎯 Use Cases của OneQR (Dynamic QR)

### 🏪 E-commerce / Web Store
- Sinh QR **động cho từng đơn hàng**
- Gửi QR trong email xác nhận hoặc checkout page
- Khách scan → Thẳng thanh toán (không cần nhập tiền)
- Tự động cập nhật khi thanh toán

### 💳 Hóa đơn điện tử
- 1 QR per invoice với số tiền đã cố định
- Email/SMS gửi QR tới khách
- Khách scan → Xác nhận → Xong (30 giây)

### 🎓 Giáo dục
- QR cho từng khoản học phí
- QR thanh toán bồi dưỡng, khóa học online
- Sinh viên scan → Trả tiền ngay

### 🏥 Y tế
- QR thanh toán viện phí cho từng bệnh nhân
- QR cho các dịch vụ khám ngoài giờ
- Bệnh nhân scan tại quầy tiếp đón

### 🎪 Sự kiện / Tổ chức
- QR vé cưới, sinh nhật, hội họp
- QR đăng ký workshop với phí
- QR quyên góp có số tiền cố định

### 🚚 Logistics / Vận chuyển
- QR thanh toán COD (tài xế scan)
- QR phí vận chuyển trước khi ship
- Tự động khớp với đơn hàng

---

## 📊 So sánh QR vs Phương pháp khác

| Tiêu chí | OneQR | Transfer thủ công | POS | BNPL |
|---------|-------|-------------------|-----|------|
| **Chi phí** | Thấp | Miễn phí | Cao ($1-3k) | Cao |
| **Tốc độ** | Tức thì | Chậm | Nhanh | Chậm |
| **Setup** | 2 phút | 0 phút | 1 ngày | 1 tuần |
| **Hỗ trợ ngân hàng** | 50+ | Chỉ 1 | 1 | Giới hạn |
| **Kỳ vọng** | Cao | Cao | Trung bình | Thấp |

---

## 🔐 Bảo mật OneQR

### ✅ An toàn như thế nào?

1. **Mã hóa SSL/TLS**: Tất cả giao dịch được mã hóa
2. **HMAC Signature**: Xác thực nguồn gốc dữ liệu
3. **Token Authentication**: Mỗi QR có token riêng
4. **Rate Limiting**: Ngăn chặn spam/fraud
5. **Webhook Verification**: Xác nhận callback từ Pay2S

### ⚠️ Những lưu ý

- **Không lưu số tiền** trên QR tĩnh (người có thể thay đổi)
- **QR động phải bảo mật** (private key phải giữ kín)
- **Kiểm tra webhook** trước cập nhật database
- **Monitor fraud patterns** để phát hiện lạm dụng

---

## 💡 Ưu và nhược điểm

### ✅ Ưu điểm
- Cực kỳ đơn giản (1 QR thay vì 10 QR)
- Hỗ trợ tất cả ngân hàng, ví
- Chi phí thấp
- Không cần thiết bị phức tạp
- Tốc độ giao dịch nhanh

### ⚠️ Nhược điểm
- Cần kết nối internet để cập nhật
- Không thích hợp cho offline (cửa hàng không internet)
- QR tĩnh dễ bị lạm dụng nếu không kiểm tra
- Cần webhook để thông báo

---

## 🚀 Xu hướng tương lai

### Các tính năng sắp tới:
- **AI Detection**: Phát hiện giao dịch đáo hạn
- **Dynamic Pricing**: Giá tự động thay đổi theo thời gian
- **Multi-currency**: Thanh toán cross-border bằng QR
- **Subscription**: Tính năng đăng ký tự động
- **Split Payment**: Chia tiền 1 QR cho nhiều người

---

## 📞 Hỗ trợ

| Nội dung | Liên hệ |
|---------|---------|
| **Kỹ thuật** | support@pay2s.vn |
| **Kinh doanh** | sales@pay2s.vn |
| **Cấp cứu** | +84-XXX-XXX-XXX |

---

> 💬 **Tiếp theo**: Xem [Tạo OneQR](/oneqr/khoi-tao-oneqr) để bắt đầu tạo mã QR của bạn!