GetBalance

URl: https://{{gmag_api_url}}/player/balance?hash={{xxx}}.

Method: POST.

Purpose: used to get a player’s balance.

Request

Name	Type	Required	Description

Name	Type	Required	Description
playerId	String(24)	Yes	The unique ID identified a Player on brand’s side.
playerBrandId	Int	No	The brand Id where the player is created. It’s needed when the Superior brand check credit for the balance of sub brand’s player.
providerCode	String(32)	No	Query player’s balance in the Superior side

Response

Name	Type	Required	Description

Name	Type	Required	Description
playerId	String(24)	Yes	The unique ID identified a Player on brand’s side.
currency	String(4)	Yes	The player’s Currency Code.
balance	numeric(16, 4)	Yes	The player’s balance.
bonusBalance	numeric(16, 4)	No	The player’s bonus balance.
timestamp	DateTime	Yes	The last updated time when the balance changed.

Request example

{
   "requestId": "requestId1234",
   "brandId": 1001,
   "playerId": "playerid1",
   “providerCode”:"vrg"
}

Response example

//success
{
   "requestId": "requestId1234",
   "playerId": "playerid1",
   "balance": "10000",
   "bonusBalance": "10100",
   "timestamp": "2021-04-10 10:12:00.123Z",  
   "error": "0",
   "message": "success",
}
//error
{
   "requestId": "requestId1234",
   "error": "P_02",
   "message": "Invalid hash",
}