Client Side Messaging

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Connect to Cursor

  Install MCP server on Cursor
• Connect to VS Code

  Install MCP server on VS Code

You can subscribe to in-game RubyPlay messages using postMessage API functionality.

Game to Wrapper Messages

Messages from the game are sent to the parent page. Each message has a standard structure and contains the following fields:

{
  type: string;
  sender: string;
  lang: string;
  data?: any;
}

1. type is a string with a specific structure rp.g2w.RedirectToLobby where:
   • rp is an abbreviation of RubyPlay
   • g2w is a direction for notification - from game to wrapper
   • RedirectToLobby is a message name
2. sender is a string with an ID code of the game from which the notification is being sent
3. lang is a string with a language code
4. data field is not mandatory and contains any additional data

{"type":"rp.g2w.payTableStatusUpdate","sender":"rp_34","lang":"en","data":{"isOpen":false}}
{"type":"rp.g2w.payTableStatusUpdate","sender":"rp_34","lang":"en","data":{"isOpen":true}}
{"type":"rp.g2w.gameRulesStatusUpdate","sender":"rp_25","lang":"da","data":{"isOpen":false}}
{"type":"rp.g2w.gameRulesStatusUpdate","sender":"rp_25","lang":"da","data":{"isOpen":true}}
{"type":"rp.g2w.paidRoundEnded","sender":"rp_76","lang":"en","data":{"win":0,"totalWin":0,"isBigWin":false}}
{"type":"rp.g2w.balanceUpdate","sender":"rp_34","lang":"en","data":{"balance":999620}}
{"type":"rp.g2w.paidRoundStarted","sender":"rp_54","lang":"es"}

The full list of messages that the game can send:

shown: boolean;
type: string;
message?: string;
        

win: number;
totalWin: number;
isBigWin: boolean;
        

betIndex: number;
bet: number;
totalBet: number;
        

rp.g2w.systemPopup

The rp.g2w.systemPopup message is sent whenever a system popup is shown or closed (e.g. errors, session timers, inactivity timers).

Message structure:

{
  shown: boolean;
  type: string;
  message?: string;
}

systemPopup type values

The type field can have one of the following values:

Values are grouped by category to improve readability.

Connection & Network

• SLOW_CONNECTION
• CONNECTION_TIMEOUT
• CONNECTION_ERROR
• LOST_CONNECTION

Game Availability

• GAME_UNAVAILABLE
• GAME_DISABLED

Balance & Funds

• INSUFFICIENT_FUNDS
• INSUFFICIENT_PROMOTION_BALANCE
• LOW_BALANCE_ERROR

Session & Limits

• SESSION_EXPIRED
• SESSION_TIME_LIMIT_REACHED
• UNRESOLVED_SESSION
• INACTIVITY_TIMER

Player & Gameplay

• PLAYER_BLOCKED
• BET_PLACE
• BROKEN_ROUND

Client Environment

• BROWSER_NOT_SUPPORTED
• WEBGL_CAN_NOT_SUPPORTED
• UNAVAILABLE_LOCATION

Promotions

• PROMOTION_TERMINATED_WARNING
• PROMOTION_TERMINATED_ERROR

{
  "type": "rp.g2w.systemPopup",
  "sender": "rp_34",
  "lang": "en",
  "data": {
    "shown": true,
    "type": "INSUFFICIENT_FUNDS",
    "message": "Not enough balance to place a bet"
  }
}

Wrapper to Game Messages

For this functionality, the casino must use the postMessage API and adhere to the following fields:

{
  type: string;
  data?: any;
}

1. type is a string with a specific structure rp.w2g.refreshBalance where:
   • rp is an abbreviation of RubyPlay
   • w2g is a direction for notification - from wrapper to game
   • refreshBalance is a message name
2. data field is not mandatory and contains any additional data

IMPORTANT: The entire message must be a JSON object. For example:

{"type":"rp.w2g.refreshBalance"}

The list of messages that the wrapper can send to the game: