Seamless Wallet API(s)
These endpoints are implemented and hosted by the operator on a registered callbackURL. PHL invokes them to synchronize the player's balance, place bets, cancel bets, and settle wins. The same common request/response envelope and signature applies.
| Callback | Endpoint | Invoked when |
|---|---|---|
| Get Player Balance | {callbackURL}/getBalance | Periodic balance sync or manual refresh |
| Place Bet | {callbackURL}/placeBet | Player places a bet |
| Cancel Bet | {callbackURL}/cancelBet | Bet fails / times out / game cancelled |
| Settle | {callbackURL}/settle | Draw settlement / payout |
See also the retry mechanisms for Cancel Bet and Settle.
Important Note
By implementing below API(s), operators are to agree upon below key metrics must be achieved.
- Service Availability – minimum uptime of 99% of the API service, excluding scheduled maintenance windows.
- Performance – The provider will ensure average response time for API requests does not exceed 1500 milliseconds for 99th percentile.
- Incident Management – The Provider will establish an incident management process for reporting and resolving API service interruptions or performance issues.
- Security – The Provider will implement appropriate security measures to protect data transmitted through the API.