VIETQR DOC
  • PHẦN MỀM APP VIETQR
    • VIETQR - Mô tả chung
      • 2️Tính năng và Ứng dụng
      • 🖥️Chức năng gói DV
        • Tài liệu VietQR - Giới thiệu sản phẩm và hướng dẫn sử dụng
        • 🔊Chrome Plugin Voice Noti
    • 👨‍👨‍👧‍👦Chia sẻ BDSD mạng xã hội
      • 🔘Chia sẻ qua Lark
      • 🔘Discord Chia sẻ BDSD
      • 🔘Slack Chia sẻ BDSD
      • 🔘Google chát & BĐSD
      • 🔘Google Sheets Oauth
      • 🔘Chia sẻ qua Telegram
    • BĐSD bằng âm thanh
  • QUY ĐỊNH CHUNG VIETQR
    • 💵Bảng giá và Phí
    • 💰Phí và thu phí
    • 🗣️Câu hỏi và trả lời
      • 1️⃣Quy định đổi thay thế tài khoản
    • ⚖️Chính sách đại lý
    • Hướng dẫn Thanh toán
    • 📝Hóa đơn và Thanh toán
    • Mở tài khoản Ngân hàng
  • THIẾT BỊ QR, PAY-BOX
    • 💺Ghế Masage QRPAY
    • 🏪Cửa ra vào QRPAY
    • 🚘Ứng dụng vào nền tảng bán vé
    • ⛽Trạm sạc điện
      • 🔘Sạc điện Ôtô, xe máy
      • 🔘Sạc Điện thoại
    • 📸Máy chụp ảnh Hàn quốc
    • 🔊QR Voice box
      • 🔘Hướng dẫn cài đặt Voice box
      • 🔘Tự mua và sản xuất QR Voice box
    • 👣D/sách máy bán hàng SAB tại HN
    • 📚Tài liêu khác
    • PayDock OutPut
  • Kêt nối đối tác Nền tảng
    • 💻Plugin Kết nối WordPress
    • 👥Plugin Bitrix24
      • Hướng dẫn cài đặt và sử dụng
        • Cài đặt App và desktop quản trị
  • API VIETQR - CALLBACK
    • Hỏi đáp API
    • 🌀API VIETQR - Host2Host
      • 🔘English version
      • Tạo môi trường test Callback
      • INTEGRATED DOCUMENT FOR PAYMENT SERVICE VIETQR
    • 💫API VIETQR - Host2Client
    • 💸API Refund Transaction
    • 📀Tài liệu kết nối VietQR
Powered by GitBook
On this page
  1. THIẾT BỊ QR, PAY-BOX

PayDock OutPut

Chuẩn Dưới đây là tài liệu mô tả thiết bị thông báo thanh toán PAYBOX của VIETQR theo chuẩn giao thức RS232 và USB:truyền thông giữ liệu

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:

    Trường
    Ý nghĩa

    FTID

    Mã giao dịch duy nhất

    Time

    Thời gian ghi nhận thanh toán (real-time)

    Amount

    Số tiền giao dịch

    Status

    Trạng thái thanh toán (e.g., SUCCESS, FAIL)

    OrderCode

    Mã đơn hàng

    POSCode

    Mã thiết bị POS

    StoreCode

    Mã cửa hàng

    BankAccount

    Số tài khoản ngân hàng thanh toán

    AccountHolder

    Tên chủ tài khoản

    CreatedTime

    Thời điểm tạo giao dịch (có thể khác Time nếu giao dịch bị delay)

    Content

    Nội dung chuyển khoản

    Note

    Ghi chú bổ sung (ví dụ: mã khuyến mãi, mã khách hàng, v.v.)

    TxnType

    Loại giao dịch (e.g., QR_STATIC, QR_DYNAMIC, LINK_PAYMENT, v.v.)


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.

PreviousTài liêu khácNextPlugin Kết nối WordPress

Last updated 4 days ago