Skip to main content
Nozle uses WebSocket for real-time entitlement updates in the browser. How it works:
  1. BillingProvider connects to WebSocket on mount
  2. Subscribes to channel: workspace:{workspaceId}:entitlements
  3. When entitlements change (plan upgrade, usage limit hit, feature toggled), Nozle publishes to the channel
  4. React hooks (useCan, usePlan) update automatically — no polling
Setup: Provide the WebSocket URL in BillingProvider: 
<BillingProvider
  apiKey="pk_live_..."
  workspaceId="ws_abc123"
  centrifugoUrl="wss://rt.nozle.app/connection/websocket"
>
  {children}
</BillingProvider>
The SDK automatically:
  1. Requests a WebSocket auth token from GET /api/v1/auth/ws-token
  2. Connects to the WebSocket
  3. Subscribes to the entitlements channel
  4. Updates the billing store on incoming messages
Connection states: The BillingState tracks connection: 
const { connectionState } = useBillingContext();
// 'connecting' | 'connected' | 'disconnected'
When updates are pushed:
  • Customer upgrades/downgrades plan
  • Usage counter crosses a limit threshold
  • Admin toggles a feature
  • Subscription is cancelled or expired
Without WebSocket: If centrifugoUrl is not provided, the React SDK falls back to REST-only mode. Hooks will fetch data on mount but won’t receive live updates. For most apps, this is fine for non-critical UI. For real-time gates (e.g., locking a feature the moment a limit is hit), WebSocket mode is recommended.