Verify User Token

The MINI.GAME platform calls this API to verify the player's identity information.

VerifySession

This API is provided by the integrator and is called by the MINI.GAME platform.

POST {ACCESS_URL}/api/user/verify_session?trace_id=minigame_trace_id

{ACCESS_URL}is the callback URL filled in by the integration partner in the backend, configuration location: Merchant Operation Backend - Settings - API Integration Configuration page.

Headers

Name	Value
Content-Type	"application/json; charset=utf-8"
sign	"mini.game_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 user, available in the merchant backend.
timestamp	integer	Timestamp (in seconds)
operator_player_session	string	The token parameter passed by the integrator from the ingame interface.
ip	string optional	User ip address
custom_parameter	string optional	Additional parameters required by the integrator
game_id	integer optional	Game ID

MINI Platform Request Parameter Example

{
    "app_id": "13",
    "timestamp": 1711954264,
    "operator_player_session": "50f15a92-ee8d-11ee-9a61-00ff3fae08f7",
    "ip": "127.0.0.1",
    "custom_parameter": "",
    "game_id": 2000001
}

Integrator Response Parameter Example

Success

{
    "data": {
        "uname": "1003803",
        "nickname": "9999999999",
        "balance":  [{
                        "currency":"usdt",
                        "amount":999.9999
            }]
       },
    "code": 1,
    "msg": "ok"
}

fail

{
      "code": 10002, 
       "msg": "sign invalid"
}

Integrator Response Parameter Example Description

Parameter	Next level	Required	Type	Description
data	——	Yes	object	Response Data
uname	——	Yes	string	User ID must be unique
nickname	——	Yes	string	User Nickname
balance	——	Yes	array	User Balance, supports up to 4 decimal places.
——	currency	Yes	String	Currency name, for details, refer to the "name" field of the supported currencies in the currency list.
——	amount	Yes	decimal	Currency Value
code	——	Yes	integer	Status Code
msg	——	Yes	string	Prompt message

Error Code

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