Integrate your hardware in minutes

VEM Cloud Open API connects any Android or Linux vending machine firmware. Complete lifecycle support from device init to order completion.

Three steps to connect your device

The Open API is REST over HTTPS with MD5 signature verification. MQTT handles real-time bi-directional communication.

1. Get API Credentials

Register a merchant account on VEM Cloud. Generate your App Key and App Secret from the Developer dashboard.

2. Initialize Your Device

Call the device init endpoint with your hardware ID and signed credentials. Receive MQTT connection details and your product catalog in one response.

3. Subscribe & Operate

Subscribe to the device command topic, then start publishing status events. Your machine is now fully cloud-managed.

Core endpoints

All calls use HTTPS with MD5 request signing. Base URL: your assigned VEM Cloud gateway.

🔌
Method
Device Management

Register hardware, synchronize product catalogs, and receive provisioned MQTT credentials — all in a single authenticated call.

  • Device registration & re-sync
  • Firmware version reporting
  • Hardware model identification
  • Diagnostic log upload
🛒
Method
Order Lifecycle

Full purchase flow from customer QR scan through payment confirmation, dispense reporting, and refund handling.

  • Order creation with payment channel
  • Dispense result reporting
  • Refund & exception handling
  • 7-state lifecycle tracking
📡
MQTT
Real-time Control

Bi-directional MQTT channel for low-latency command delivery and continuous status telemetry, all over TLS-secured connections.

  • Remote command reception
  • Heartbeat & status publishing
  • Fault code & alarm reporting
  • Command acknowledgment protocol
🔐 Full API documentation, endpoint reference, and SDK samples are provided after account activation. Contact us to request access.

Real-time bi-directional communication

Powered by an enterprise-grade MQTT broker cluster. Devices receive commands and push status events over a dedicated, TLS-secured channel provisioned at registration.

SUBSCRIBE (device receives)
Command Channel
Per-device · Isolated · Authenticated

Platform sends remote commands: restart, config update, screen push, lock, log pull, OTA trigger.

PUBLISH (device sends)
Event Channel
Real-time · QoS 1 · Persistent

Device reports status heartbeats, order events, dispense results, fault codes and sensor telemetry.

Request signing

Every Open API call requires a cryptographic signature. This prevents replay attacks and ensures your App Secret never leaves your hardware.

Collect parameters

Gather all request parameters — your App Key, a Unix timestamp, and the call's business fields — into a single parameter map.

Sort & concatenate

Sort the parameter names alphabetically, join them as key=value pairs, then append your App Secret. The secret never leaves your hardware.

Hash & submit

MD5-hash the resulting string, uppercase the hex output, and include it as the signature field in your request. The gateway rejects any mismatch.

Ready to modernize your
vending operations?

VEM Cloud Open API connects any Android or Linux vending machine firmware. Complete lifecycle support from device init to order completion.