Create Player Token
API provided by the game platform; called by the merchant (operator).
First step in wallet transfer flow: generate a token the player will use in platform games. This generates a NEW authorization token valid for 7 days. After 7 days you may call again to refresh; the previous token becomes invalid immediately. Merchants should manage token refresh ahead of expiration.
Subsequent wallet transfer, balance query, and transfer status APIs all require this token. Use the returned UTC expiry time to decide when to refresh proactively to ensure seamless play.
Request URL
POST {API_URL_ROOT}/auth/createToken
Request Parameters
Header
| Field | Required | Type | Description |
|---|---|---|---|
| sign | YES | string | Signature computed using the Signature Algorithm. |
| timestamp | YES | int | UTC timestamp in seconds since 1970-01-01, e.g. 1741837297. |
| Accept-Language | YES | string | Language codes, see Language List. |
| Content-Type | YES | string | "application/json; charset=utf-8" |
Body
| Field | Required | Type | Description |
|---|---|---|---|
| tenantId | YES | int | Merchant ID assigned by the platform. |
| userId | YES | string | Merchant's player ID. |
| currency | NO | string | Currency code. Required if merchant supports multiple currencies. |
Example
{
"tenantId": 1,
"userId": "t1_225478",
"currency": "BRL"
}
Response Parameters
| Field | Required | Type | Description |
|---|---|---|---|
| token | YES | string | Authorization token. |
| expires | NO | DateTime | Expiration time (UTC). |
Example
{
"isSuccess": true,
"code": 0,
"data": {
"token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzaWQiOiI2N2QzYzM5NzFlN2NhNDYxNWRhZWQxMjUiLCJzdWIiOiJ0MV8yMjU0NzgiLCJ0ZW5hbnQiOiIxIiwibmJmIjoxNzQxOTMxNDE1LCJleHAiOjE3NDIwMTc4MTUsImlzcyI6InRoZWEiLCJhdWQiOiJ0aGVhIn0.L1OQa7cF0iFeGXwM1yd7nMeoiHk17EwkmWO_egJxGhQMrTzvcYTgnyJjZF9RH4dx-OPtbvMzZIjf7mV1C2mcV-s2ya_GNrf_6JlRONBzuRuOlAgD_PRWmdptuyPd8cH5n0IXENMOZ3xQ4W2MIy1EMw7snKIJXuMscC82ZsrDEqQ",
"expires": "2025-03-15 05:50:15"
}
}