Webhook Endpoints
Player Balance
Query current player balance
POST {api_base_url}/player-balance
Called to query a player's current balance. Used for balance synchronization during gameplay.
Request
{
"player_id": "player_123"
}| Field | Type | Description |
|---|---|---|
player_id | string | Player to look up |
Response
{"type": "SUCCESS", "balance": 1234.56, "timestamp": 1712401234567}If the player doesn't exist:
{"type": "ERROR", "code": "PLAYER_NOT_FOUND"}Always return HTTP 200.
Notes
- The balance should reflect all completed transactions (withdraws, deposits, rollbacks)
- This endpoint is called frequently - keep it fast (under 100ms recommended)
- Like all webhook endpoints, verify the signature before responding