Game Transfer API Documentation

The Transfer API provides a controlled, request-based method for managing player accounts, balances, and gameplay sessions. Instead of relying on continuous real-time communication like seamless wallet systems, it moves funds only when explicitly instructed. This makes the integration straightforward and predictable for platforms that prefer fixed, auditable balance flows.

Key Advantage: Your system decides exactly when to credit or deduct funds. No background wallet sync is required, which reduces risk and simplifies reconciliation.

Why Use the Transfer API?

Full control: Your platform triggers every credit and debit.
No live sync issues: No dependency on real-time wallet updates during gameplay.
Risk isolation: The game provider never holds a live wallet balance.
Clear audit trail: Every transaction has timestamps and precise amounts.
Simpler compliance: All movements are explicit and easy to export.

With seamless APIs, the user’s balance must stay synchronized throughout gameplay, and any delay or API timeout can lead to inaccurate wallet states or reconciliation headaches. The Transfer API avoids these pitfalls by using a closed-loop flow:

Deposit before entry
Withdraw after exit
No mid-game balance change unless you trigger it

Create Player

Create a player account in the game system.

Endpoint

Method	URL	Description
POST	`https://api3.qianxu168.com/player/account/create`	Create a new player in the game environment.

Request Body

{
  "playerId": "susu",
  "domain": "thai.com",
  "playerNickname": "Su Su",
  "profile": "9"
}

Field	Type	Required	Description
`playerId`	string	Yes	Unique ID for the player.
`domain`	string	Yes	Platform/domain the player belongs to.
`playerNickname`	string	Yes	Display name for the player.
`profile`	string	No	Profile code or avatar index.

Response

{
  "status": "ok"
}

Field	Type	Description
`status`	string	`"ok"` if the player was created successfully.

Transfer Balance

Transfer funds for a player using a signed amount. The sign of amount defines the direction:
+amount = add funds to the game system, -amount = deduct funds from the game system.

Endpoint

Method	URL	Description
POST	`http://api3.qianxu168.com/balance/transfer`	Transfer balance for a specific player.

Request Body

{
  "playerId": "susu",
  "domain": "thai.com",
  "amount": 1000
}

Field	Type	Required	Description
`playerId`	string	Yes	Target player ID.
`domain`	string	Yes	Player's domain.
`amount`	number	Yes	Signed amount controlling transfer direction: • `> 0` – add funds to the game system (increase game wallet balance). • `< 0` – deduct funds from the game system (decrease game wallet balance). The game balance will change by this exact value.

Response

{
  "balance": 1144,
  "status": "ok"
}

Field	Type	Description
`balance`	number	Updated player balance after transfer.
`status`	string	`"ok"` if the transfer was successful.

Get Player Status

Query a player’s current balance and activity state.

Endpoint

Method	URL	Description
POST	`https://api3.qianxu168.com/player/account/status`	Get current balance and state for a player.

Request Body

{
  "playerId": "susu",
  "domain": "thai.com"
}

Field	Type	Required	Description
`playerId`	string	Yes	Player identifier to query.
`domain`	string	Yes	Player's domain.

Response

{
  "balance": 144.5,
  "playerState": "idle",
  "status": "ok"
}

Field	Type	Description
`balance`	number	Player's current balance.
`playerState`	string	Current activity state (e.g. `idle`, `playing`).
`status`	string	`"ok"` if the request was successful.

Start Game

Start a game session for a player and receive a game launch URL.

Endpoint

Method	URL	Description
POST	`https://api3.qianxu168.com/game/start`	Create a game session and return a game URL.

Request Body

{
  "playerId": "susu",
  "domain": "thai.com",
  "gameId": "ShanKoeMee",
  "lobbyURL": "https://game.casino909.com",
  "level": 0
}

Field	Type	Required	Description
`playerId`	string	Yes	Player launching the game.
`domain`	string	Yes	Player's domain.
`gameId`	string	Yes	Game identifier.
`lobbyURL`	string	Yes	Redirect URL after the player exits the game.
`level`	number	No	Game difficulty or entry level.

Response

{
  "gameURL": "http://localhost:7456/?id=susu&passcode=PNvyhLCEclnvryMYQWDT&domain=thai.com&game=ShanKoeMee&key=OxwVHnFASiEKBjIECQE4G190U1xmRw&exit=https://game.casino909.com",
  "status": "ok"
}

Field	Type	Description
`gameURL`	string	URL used to launch the game session (in iframe or new tab).
`status`	string	`"ok"` if the game session was created successfully.