BSbest-system API Docs
ไทย

Seamless Wallet API

SEAMLESS mode — you hold the player wallet. best-system calls your wallet API synchronously, per transaction

The 10 endpoints

EndpointWallet directionWhen it is called
POST /api/balancereadRead the balance (no money movement)
POST /api/betdebitPlace a bet
POST /api/settlecreditPay out winnings
POST /api/refundcreditCancel a bill, return the stake (REFUND/REJECT)
POST /api/rewardcreditJackpot / bonus
POST /api/rollbackdebitTake back an already-paid settle
POST /api/voidnetCancel the whole round (carries a direction field)
POST /api/tipdebitDealer tip
POST /api/cancel-tipcreditCancel a tip
POST /api/adjustnetBet adjustment / fishing (carries a direction field)

Getting started in 5 steps

  1. Get credentials + register your callback URL — best-system issues your api_key/secret and registers your seamless_callback_url on the bo screen: Api Management → API Credential
  2. Implement all 10 endpoints in the table above
  3. Verify the signature on every request — X-Api-Key + HMAC over the raw bytes; see Authentication
  4. Make it atomic + idempotent — one batch rolls back as a whole, a re-sent call must never double-charge; see Contract
  5. Test with the best-system team before go-live — walk through every endpoint, including the retry (idempotency), insufficient-balance and single-state settle cases