Xác định đường dẫn MDB
Xác nhận xem máy là tiêu chuẩn MDB, bộ điều khiển tủ, bộ điều khiển cà phê hay hệ thống dây điện bán hàng tự động hỗn hợp.
MDB tích hợp bán hàng tự động
MDB máy bán hàng tự động API cổng dành cho các máy do máy chủ điều khiển.
Sử dụng QuLink giữa máy bán hàng tự động và đám mây của bạn khi máy sử dụng MDB, cần kiểm soát nhà cung cấp từ xa, trình kích hoạt gọi lại thanh toán, tải lên telemetry hoặc đường dẫn trang bị thêm không thay thế toàn bộ máy.
MDB xử lý giao thứcLệnh bán hàng + kết quảTelemetry tải lênThanh toán QR tùy chọn
Thông tin chính
Những điều cần biết trước khi chọn cổng MDB API.
MDB mục tiêu
MDB 4.2/4.3 là đường dẫn đích; phiên bản cũ hơn cần xem lại.
Lớp lệnh
Các sự kiện bán hàng, trạng thái, kết quả và lỗi giữa máy chủ và bộ điều khiển của bạn.
Quyền sở hữu thanh toán
Giữ PSP, ví hoặc đầu đọc của bạn; QuLink xử lý hành động phía máy.
Mẫu đầu tiên
Một máy xác nhận hành vi thời gian, ánh xạ và kết quả.
Mẫu đang chờ xử lý: thông báo MDB chính xác, ánh xạ bán hàng, thời gian chờ và hành vi kết quả được xác nhận trên máy.
MDB lớp điều khiển
Cổng MDB API bổ sung thêm những gì.
Cổng không phải là bên thu thanh toán và không phải là nơi thay thế toàn bộ bộ điều khiển.
| Lớp | Nó làm gì | Xác nhận điều gì | Những gì nó không thay thế |
|---|---|---|---|
| MDB cổng | Bản đồ các lệnh và sự kiện giữa máy chủ và bộ điều khiển bán hàng tự động. | Phiên bản MDB, dây nịt, ánh xạ sự kiện. | Việc thanh toán hoặc giải quyết. |
| Bảng không tiền mặt | Gửi ủy quyền qua đường dẫn không dùng tiền mặt MDB. | Reader/PSP, luồng ủy quyền, kết quả bán hàng. | Một điều khiển hoàn chỉnh API. |
| Cầu dữ liệu | Gửi trạng thái, lỗi hoặc cách sử dụng tới chương trình phụ trợ của bạn. | Giao diện và các trường có sẵn. | Ủy quyền thanh toán. |
| Bộ điều khiển | Sở hữu hành vi phân phối và an toàn. | Tài liệu máy và mẫu. | Bộ điều khiển mới hoặc chứng nhận an toàn. |
Vai trò có thể chồng chéo. Mẫu xác nhận sự kết hợp nào ổn định cho máy.
Độ phù hợp dự án
Dành cho máy bán hàng tự động MDB do máy chủ điều khiển
Tín hiệu nhu cầu
- Người vận hành hoặc OEM xây dựng máy bán hàng tự động, máy pha cà phê, máy bán lẻ thông minh hoặc máy đóng tủ.
- Phần mềm cần kích hoạt trả thù, trạng thái truy vấn hoặc nhận kết quả trả thù.
- Các khoản thanh toán cần QR, gọi lại ví hoặc phê duyệt ứng dụng trước hành động bán hàng.
- Các dự án cần xử lý MDB mà không cần xây dựng lại thời gian từ đầu.
Cần gửi gì
- Ảnh máy hoặc bo mạch hiện tại
- Ghi chú giao diện hoặc đấu dây
- Hành động mục tiêu sau API hoặc thanh toán
- Có cần upload dữ liệu không
Không phù hợp nếu
- Bộ điều khiển không có đường dẫn MDB có thể sử dụng được và không thể đánh giá được từ ảnh.
- Bạn cần một người thu thanh toán thay vì kiểm soát phía máy.
- Không có thông tin về máy, bộ điều khiển hoặc hệ thống dây điện cho một mẫu.
Mô hình tích hợp
Lớp lệnh và sự kiện giữa máy chủ và MDB
Bo mạch QuLink nằm ở phía máy, xử lý giao tiếp MDB và hiển thị các luồng lệnh và sự kiện tới máy chủ của bạn.
- Giao diện máy
- MDB, hệ thống dây điện của bộ điều khiển bán hàng tự động, rơle tùy chọn hoặc thiết bị phụ trợ nối tiếp
- Phía máy chủ
- Lệnh API, sự kiện webhook, gọi lại telemetry, tham chiếu thanh toán
- Hành động điển hình
- phân phối, start_session, query_status, vend.result, machine.fault
- Chế độ dự án
- mẫu trang bị thêm, triển khai toán tử, tùy chỉnh bộ điều khiển OEM
Quy trình
Từ ảnh máy đến quy trình đã kiểm chứng.
Bản đồ hành động bán hàng
Xác định vị trí/sản phẩm, ủy quyền, tham chiếu thanh toán, thời gian chờ và báo cáo kết quả.
Kết nối sự kiện máy chủ
Phần phụ trợ của bạn nhận được trạng thái trực tuyến, kết quả bán hàng, cảnh báo lỗi và telemetry.
Kiểm tra máy thật
Chạy các lệnh mẫu trên phần cứng thực tế trước khi triển khai hàng loạt.
Ví dụ API
Ví dụ lệnh server hoặc webhook cho hành động phía máy.
Các trường lệnh phụ thuộc vào giao diện máy, cấu hình firmware và việc thanh toán hay ứng dụng của bạn kích hoạt hành động.
POST /v1/devices/VM-1049/commands
{
"command": "dispense",
"source": "payment_confirmed",
"machine_action": {
"interface": "mdb",
"slot": "A07"
},
"reference_id": "PAY-2026-1049"
}
Project RFQ
Cho chúng tôi biết máy cần làm gì, gửi gì, hoặc báo cáo gì.
Gửi mẫu máy bán hàng tự động, ảnh MDB, ảnh bảng, quy trình thanh toán và hành động bán hàng mà bạn cần.
A good first message
If you are unsure about the exact interface, send what you have. Photos often answer more than a long spec.
- Machine type and target country
- Machine photo, board photo, or wiring photo
- Action after payment or API command
- Need data upload? expected quantity?
Fastest first step
- Send a machine photo
- Describe the action after API or payment
- Tell us if data upload is needed
FAQ
Câu hỏi thường gặp trước khi test mẫu.
QuLink có thể hoạt động với ứng dụng thanh toán hiện có không?
Vâng. Ứng dụng hoặc máy chủ thanh toán của bạn có thể xác nhận thanh toán trước, sau đó gọi QuLink để kích hoạt hành động bán hàng MDB.
Chúng ta có cần thay thế toàn bộ bộ điều khiển bán hàng tự động không?
Không phải lúc nào cũng vậy. Nhiều dự án bắt đầu như một cổng trang bị thêm. Có thể đánh giá việc thay thế bộ điều khiển OEM khi cần triển khai lặp lại.
Hội đồng quản trị có thể tải lên dữ liệu bán hàng tự động?
Vâng. QuLink có thể báo cáo trạng thái trực tuyến của thiết bị, kết quả bán hàng, sự kiện lỗi, nhật ký sử dụng và telemetry tới máy chủ của bạn.
Phiên bản MDB nào được nhắm mục tiêu?
MDB 4.2/4.3 là hồ sơ mục tiêu. Các phiên bản cũ hơn và hành vi tùy chỉnh yêu cầu xem xét và lấy mẫu máy thực.
Chúng ta nên gửi gì trước?
Mẫu máy, bộ điều khiển và ảnh MDB, quy trình thanh toán, hành động bán hàng mục tiêu và dữ liệu bạn cần lấy lại.
Trường hợp liên quan