Get User Balance

The integrator queries the user's balance on the OMG platform.

GetPlayerWallet

This API is provided by the OMG platform and is called by the integrator.

POST {OMG_API_URL}/api/cash/v1/getPlayerWallet?trace_id=your_trace_id

{OMG_API_URL} is the OMG API domain, which can be obtained from the backend.

Headers

Name	Value
Content-Type	"application/json; charset=utf-8"
sign	"your_sign_string"

Please refer to the Signature Algorithm and Example page for details on the signature algorithm.

Body

Name	Type	Description
app_id	string	The unique identifier for the merchant, available in the merchant backend.
token	string	The user's token on the OMG platform can be obtained through the Get User Game Token API.
timestamp	integer	Timestamp (in seconds)

Integrator Request Parameter Example

{
    "app_id": "10013",
    "timestamp": 1711954264,
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjcmVhdGUiOjE3MTk2Mjk2NDQsInVzZXIiOiJ7XCJpZFwiOjM1NzE0MSxcIm9wZXJhdGVyX2lkXCI6MSxcImFnZW50X2lkXCI6MTAwMDIwLFwiYXBwX2lkXCI6MTAzMSxcImFjY291bnRfdHlwZVwiOjAsXCJ2YWx1ZVwiOlwiMVwiLFwibm93X2dhbWVfaWRcIjowfSJ9.tXfaavxZu7PIedpJ5Tp7oL0aBEnb5ujok4cbKWoNj0U"
}

OMG Platform Response Parameter Example

Success

{
    "code": 0,
    "msg": "ok",
    "data": {
        "balance": "4299.18"
    }
}

Failed

Response Example Parameter Descriptions

Name	Required	Type	Description
code	Yes	integer	Status Code
msg	Yes	string	Message
data	Yes	object	Response Data
balance	Yes	string (decimal)	User balance, supports up to 4 decimal places

Error Code

For more error codes, please refer to the General Error Codes page description.