# PayDock OutPut

### **TÀI LIỆU MÔ TẢ THIẾT BỊ PAYBOX CỦA VIETQR**

#### **1. Giới thiệu tổng quan**

PAYBOX là thiết bị phần cứng do VIETQR phát triển nhằm hỗ trợ doanh nghiệp nhận thông báo thanh toán theo thời gian thực. Thiết bị hỗ trợ hai chuẩn giao tiếp phổ biến là **RS232** và **USB**, cho phép tích hợp dễ dàng với các hệ thống POS, máy tính tiền, máy in hóa đơn, hoặc phần mềm bán hàng nội bộ.

Mô tả kỹ thuật  : 

Thiết bị PayBox là 1 sản phẩm Phần cứng hỗ trợ thanh toán và điều khiển tự động giúp cho người dùng tạo QR thanh toán và xử lý  tự động hóa thanh toán và Dich vụ

Ứng dụng : 

***

#### **2. Chuẩn giao tiếp và định dạng dữ liệu**

PAYBOX truyền dữ liệu thanh toán đến hệ thống nhận theo chuẩn:

* **Giao tiếp vật lý**:
  * RS232 (9 chân chuẩn DB9, tốc độ 9600 bps hoặc tùy chỉnh)
  * USB (tương thích HID hoặc COM ảo)
* **Định dạng dữ liệu truyền**:\
  Dữ liệu được truyền dưới dạng chuỗi ký tự, ngăn cách bằng dấu gạch đứng `|`, theo thứ tự như sau:

  ```
  <FTID>|<Time>|<Amount>|<Status>|<OrderCode>|<POSCode>|<StoreCode>|<BankAccount>|<AccountHolder>|<CreatedTime>|<Content>|<Note>|<TxnType>
  ```

  **Chi tiết các trường dữ liệu:**

  <table><thead><tr><th width="210">Trường</th><th>Ý nghĩa</th></tr></thead><tbody><tr><td><code>FTID</code></td><td>Mã giao dịch duy nhất</td></tr><tr><td><code>Time</code></td><td>Thời gian ghi nhận thanh toán (real-time)</td></tr><tr><td><code>Amount</code></td><td>Số tiền giao dịch</td></tr><tr><td><code>Status</code></td><td>Trạng thái thanh toán (e.g., SUCCESS, FAIL)</td></tr><tr><td><code>OrderCode</code></td><td>Mã đơn hàng</td></tr><tr><td><code>POSCode</code></td><td>Mã thiết bị POS</td></tr><tr><td><code>StoreCode</code></td><td>Mã cửa hàng</td></tr><tr><td><code>BankAccount</code></td><td>Số tài khoản ngân hàng thanh toán</td></tr><tr><td><code>AccountHolder</code></td><td>Tên chủ tài khoản</td></tr><tr><td><code>CreatedTime</code></td><td>Thời điểm tạo giao dịch (có thể khác <code>Time</code> nếu giao dịch bị delay)</td></tr><tr><td><code>Content</code></td><td>Nội dung chuyển khoản</td></tr><tr><td><code>Note</code></td><td>Ghi chú bổ sung (ví dụ: mã khuyến mãi, mã khách hàng, v.v.)</td></tr><tr><td><code>TxnType</code></td><td>Loại giao dịch (e.g., QR_STATIC, QR_DYNAMIC, LINK_PAYMENT, v.v.)</td></tr></tbody></table>

***

#### **3. Lợi ích của hệ thống PAYBOX**

* ✅ **Thông báo giao dịch tức thời**: Thiết bị đảm bảo người bán nắm được trạng thái thanh toán ngay lập tức, tránh thất thoát.
* ✅ **Tích hợp dễ dàng**: Với RS232 và USB, PAYBOX có thể kết nối với phần mềm hiện có mà không cần thay đổi hệ thống.
* ✅ **Chuẩn dữ liệu rõ ràng**: Định dạng truyền thống nhất quán, dễ phân tích, log và xử lý tự động.
* ✅ **Giảm thời gian thao tác**: Nhân viên không cần mở ứng dụng để kiểm tra từng giao dịch, giảm tải và tăng hiệu suất làm việc.
* ✅ **Phù hợp đa nền tảng**: PAYBOX hoạt động tốt với Windows, Linux hoặc hệ điều hành nhúng của máy POS.
* ✅ **Tăng độ tin cậy vận hành**: Thiết bị chuyên dụng giảm thiểu rủi ro lỗi phần mềm hoặc trễ thông tin như khi dùng điện thoại.

***

#### **4. Ứng dụng thực tiễn**

* 💼 **Nhà hàng/quán café**: Nhận thông báo chuyển khoản để phục vụ khách nhanh chóng.
* 🛍️ **Cửa hàng bán lẻ**: Đồng bộ thông tin thanh toán vào hệ thống ERP/kho/xuất hóa đơn.
* 🏪 **Máy POS không màn hình**: Thiết bị PAYBOX sẽ đọc dữ liệu và truyền vào hệ thống.
* 🏧 **Kiosk/Thiết bị tự động**: PAYBOX giúp thiết bị xử lý thanh toán không tiền mặt một cách thông minh.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.vietqr.vn/doc/giai-phap-va-ung-dung-vietqr/paydock-output.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.