WebSocket Events

Real-time terminal events via STOMP over WebSocket. Requires the ws:subscribe scope for integrators.

WS/queue/terminal/{configId}🔒 ws:subscribe

Subscribe to real-time events for a specific terminal. Events include PAYMENT_STATUS, FORCE_REFRESH, PRINT, and CONFIG_UPDATE. Connect via STOMP 1.2 over SockJS.

Auth: Bearer JWT (as STOMP header)

Response Example

// STOMP CONNECT
CONNECT
Authorization:Bearer <jwt>
accept-version:1.2
heart-beat:10000,10000

// SUBSCRIBE to terminal events
SUBSCRIBE
id:sub-0
destination:/queue/terminal/123

// Incoming MESSAGE
MESSAGE
destination:/queue/terminal/123
content-type:application/json

{
  "type": "PAYMENT_STATUS",
  "referenceId": "REF-001",
  "status": "SUCCESS",
  "amount": "10.00"
}