Version 1.0.1 (3 Jun 2025)
You can use these APIs to retrieve information, integrate games, and enjoy various services provided by GameFusion — such as obtaining game access URLs, adjusting player balances, and synchronizing betting records. All OpenAPIs included in this document are optional; operators may choose to integrate only the APIs they need.
POST
For each request, access permissions are verified by checking the token information carried in the request headers to ensure the security of every request. A complete example of an API call is shown below: the Authorization and clientid in the request header are used for authentication, and must be included with every request.
Request:
| Parameter |
Location |
Type |
Default |
Description |
| apiKey |
body |
string |
required |
API Key (authentication token used to access the system).
Format: /^[A-Za-z0-9]+$/
Length: 26
|
| operatorId |
body |
string |
required |
Operator ID (unique numeric identifier of the operator).
Format: /^[0-9]+$/
Length: 19
|
Response:
| Parameter |
Type |
Default |
Description |
| access_token |
string |
required |
Access Token (JWT for access authorization).Format: /^[A-Za-z0-9\-_]+\.[A-Za-z0-9\-_]+\.[A-Za-z0-9\-_]+$/Length: 351 |
| client_id |
string |
required |
Client ID (32-character lowercase hexadecimal application identifier).Format: /^[a-f0-9]{32}$/Length: 32 |
| expire_in |
long |
required |
Expire In (token expiration time in seconds).Format: `/^[0-9]{1,6}$/`Length: 6 |
POST
The user can get a list of games with the base information available for its operator.
Request:
| Parameter |
Location |
Type |
Default |
Description |
operatorId |
|
|
|
| clientId |
header |
string |
required |
Client id |
| Authorization |
header |
string |
required |
Authorization token |
| providerId |
body |
string (16) |
|
Game category’s public ID that searched games should be assigned to. |
| Jackpots |
body |
boolean | true or false |
|
Adding jackpots info to game info. |
| isFreebetSupported |
body |
boolean | true or false |
|
It is true, if searched games should support freebets. |
| sortBy |
body |
string (32) |
|
Sorting fields. Allowed values are:
'code'
'title'
'providerTitle'
'providerCode'
'categoryList'
|
| sortOrder |
body |
string (4) |
|
Sorting order: ASC or DESC. |
| page |
body |
integer |
|
Page number. Default value is 1. |
| perPage |
body |
integer |
|
Number of items to return. Default value is 50. |
Response:
POST
Retrieves the access URL for launching a specific game.
Request:
| Parameter |
Location |
Type |
Default |
Description |
| clientId |
header |
string |
required |
Client id |
| Authorization |
header |
string |
required |
Authorization token |
| requestId |
body |
string |
required |
Request ID for debugging purposes, the response will return the ID. |
| playerId |
body |
string |
required |
Operator user's unique identifier
|
| playerName |
body |
string |
required |
Player nameFormat: /[A-Za-z0-9.\/,_-]+/Length: 2 - 32
|
| gameId |
body |
string |
required |
Game Id
|
| clientPlatform |
body |
string |
required |
Client type — user device type (e.g., pc)
|
| currencyCode |
body |
string |
required |
Game currency, default is 'CNY' (see appendix for details)
|
| country |
body |
string |
required |
Country/Region (see appendix for details)
|
| operatorId |
body |
string |
required |
Operator id — a unique identifier assigned to the operator after merchant creation
|
| homeUrl |
body |
string |
required |
Operator lobby URL — the URL the game returns to when the homepage button is clicked
|
| ipAddress |
body |
string |
required |
User IP address
|
| languageCode |
body |
string |
|
Game language, default is 'zh' (see appendix for details)
|
Response:
| Parameter |
Type |
Default |
Description |
actionType jumpType |
string |
required |
url for URL redirection, html for intermediate page rendering. |
| url |
string |
required |
Game url |
| html |
string |
required |
Game html |
| requestId |
string |
required |
Request ID for debugging purposes, the response will return the ID. |
POST
Processes a deposit request to add funds to the user's wallet.
Request:
| Parameter |
Location |
Type |
Default |
Description |
operatorId |
|
|
|
| clientId |
header |
string |
required |
Client id |
| Authorization |
header |
string |
required |
Authorization token |
| playerId |
body |
string |
required |
Operator user's unique identifier |
| playerName |
body |
string |
required |
Player nameFormat: /[A-Za-z0-9.\/,_-]+/Length: 2 - 32
|
| currencyCode |
body |
string |
required |
Currency code (eg., CNY, MYR) |
externaltransactionId transferId |
body |
string |
required |
External transaction id (Unique)
|
| amount |
body |
decimal |
required |
Amount to be depositdecimalPrecision: 22decimalScale: 2
|
| providerId |
body |
string |
required |
Game provider's id
|
| requestId |
body |
string |
required |
Request ID for debugging purposes, the response will return the ID. |
Response:
| Parameter |
Type |
Default |
Description |
failMsg |
|
|
|
| playerId |
string |
required |
Operator user's unique identifier |
| playerName |
string |
required |
Player name Format: /[A-Za-z0-9.\/,_-]+/Length: 2 - 32 |
| amount |
decimal |
required |
Amount to be depositdecimalPrecision: 22decimalScale: 2 |
| currentplayerbalance |
decimal |
required |
Current balancedecimalPrecision: 22decimalScale: 2 |
externaltransactionId transferId |
string |
required |
External transaction id (Unique) |
| transactiontime |
date |
required |
Transaction time |
transactionId tradeId |
string |
required |
Transaction ID issued by the platform |
transactionStatus tradeState |
string |
required |
Transaction status (eg,.Deposit OK) |
| requestId |
string |
required |
Request ID for debugging purposes, the response will return the ID. |
POST
Processes a withdrawal request to deduct funds from the user's wallet.
Request:
| Parameter |
Location |
Type |
Default |
Description |
operatorId |
|
|
|
| clientId |
header |
string |
required |
Client id |
| Authorization |
header |
string |
required |
Authorization token |
| playerId |
body |
string |
required |
Operator user's unique identifier |
| playerName |
body |
string |
required |
Player name Format: /[A-Za-z0-9.\/,_-]+/Length: 2 - 32 |
| currencyCode |
body |
string |
required |
Currency code (eg., CNY, MYR) |
externaltransactionId transferId |
body |
string |
required |
External transaction id (Unique) |
| amount |
body |
decimal |
required |
Amount to be withdrawdecimalPrecision: 22decimalScale: 2 |
| providerId |
body |
string |
required |
Game provider's id |
| requestId |
body |
string |
required |
Request ID for debugging purposes, the response will return the ID. |
Response:
| Parameter |
Type |
Default |
Description |
failMsg |
|
|
|
| playerId |
string |
required |
Operator user's unique identifier |
| playerName |
string |
required |
Player name Format: /[A-Za-z0-9.\/,_-]+/Length: 2 - 32 |
| amount |
decimal |
required |
Amount to be withdrawdecimalPrecision: 22decimalScale: 2 |
| currentplayerbalance |
decimal |
required |
Current balancedecimalPrecision: 22decimalScale: 2 |
externaltransactionId transferId |
string |
required |
External transaction id (Unique) |
| transactiontime |
date |
required |
Transaction time |
transactionId tradeId |
string |
required |
Transaction ID issued by the platform |
transactionStatus tradeState |
string |
required |
Transaction status (eg,.Withdraw OK) |
| requestId |
string |
required |
Request ID for debugging purposes, the response will return the ID. |
POST
Retrieves the status of a specific wallet transfer request.
Request:
| Parameter |
Location |
Type |
Default |
Description |
| clientId |
header |
string |
required |
Client id |
| Authorization |
header |
string |
required |
Authorization token |
transactionId tradeId |
body |
string |
required |
Transaction ID issued by the platform |
| requestId |
body |
string |
required |
Request ID for debugging purposes, the response will return the ID. |
Response:
| Parameter |
Type |
Default |
Description |
failMsg |
|
|
|
transactionId tradeId |
string |
required |
Transaction ID issued by the platform |
status tradeState |
string |
required |
Status (eg,. approved | declined | waiting | unknown) |
| type |
string |
required |
Type (eg., deposit | withdraw) |
| amount |
decimal |
required |
Amount to be deposit or withdrawdecimalPrecision: 22decimalScale: 2 |
| currentplayerbalance |
decimal |
required |
Current balancedecimalPrecision: 22decimalScale: 2 |
| transactiontime |
datetime |
required |
Transaction time |
| requestId |
string |
required |
Request ID for debugging purposes, the response will return the ID. |
POST
Retrieves the current balance of the user's wallet.
Request:
| Parameter |
Location |
Type |
Default |
Description |
operatorId |
|
|
|
| clientId |
header |
string |
required |
Client id |
| Authorization |
header |
string |
required |
Authorization token |
| playerId |
body |
string |
required |
Operator user's unique identifier |
| playerName |
body |
string |
required |
Player name Format: /[A-Za-z0-9.\/,_-]+/Length: 2 - 32 |
| currencyCode |
body |
string |
required |
Currency code (eg., CNY, MYR) |
| providerId |
body |
string |
|
Game provider's id |
| requestId |
body |
string |
required |
Request ID for debugging purposes, the response will return the ID. |
Response:
| Parameter |
Type |
Default |
Description |
| requestId |
string |
required |
Request ID for debugging purposes, the response will return the ID. |
| data |
array of player balance data |
required |
POST
Retrieves detailed information about a specific player.
Request:
| Parameter |
Location |
Type |
Default |
Description |
operatorId |
|
|
|
| clientId |
header |
string |
required |
Client id |
| Authorization |
header |
string |
required |
Authorization token |
| playerId |
body |
string |
required |
Operator user's unique identifier |
| playerName |
body |
string |
required |
Player name Format: /[A-Za-z0-9.\/,_-]+/Length: 2 - 32 |
| providerId |
body |
string |
|
Game provider's id |
| requestId |
body |
string |
required |
Request ID for debugging purposes, the response will return the ID. |
Response:
| Parameter |
Type |
Default |
Description |
| playerId |
string |
required |
Operator user's unique identifier |
| playerName |
string |
required |
Player name Format: /[A-Za-z0-9.\/,_-]+/Length: 2 - 32 |
| requestId |
string |
required |
Request ID for debugging purposes, the response will return the ID. |
| wallets |
array of player wallets data |
required |
POST
Retrieves the current online status of a specific player.
Request:
| Parameter |
Location |
Type |
Default |
Description |
operatorId |
|
|
|
| clientId |
header |
string |
required |
Client id |
| Authorization |
header |
string |
required |
Authorization token |
| playerId |
body |
string |
required |
Operator user's unique identifier |
| playerName |
body |
string |
required |
Player name Format: /[A-Za-z0-9.\/,_-]+/Length: 2 - 32 |
| providerId |
body |
string |
|
Game provider's id |
| requestId |
body |
string |
required |
Request ID for debugging purposes, the response will return the ID. |
Response:
| Parameter |
Type |
Default |
Description |
| requestId |
string |
required |
Request ID for debugging purposes, the response will return the ID. |
| data |
array of player online status |
required |
POST
Logs out the specified player from the system.
Request:
| Parameter |
Location |
Type |
Default |
Description |
operatorId |
|
|
|
| clientId |
header |
string |
required |
Client id |
| Authorization |
header |
string |
required |
Authorization token |
| playerId |
body |
string |
required |
Operator user's unique identifier |
| playerName |
body |
string |
required |
Player name Format: /[A-Za-z0-9.\/,_-]+/Length: 2 - 32 |
| providerId |
body |
string |
required |
Game provider's id |
| requestId |
body |
string |
required |
Request ID for debugging purposes, the response will return the ID. |
Response:
| Parameter |
Type |
Default |
Description |
data |
|
|
|
| requestId |
string |
required |
Request ID for debugging purposes, the response will return the ID. |
| msg |
string |
required |
Logout message |
POST
Retrieves the current balance of the operator wallet.
Request:
| Parameter |
Location |
Type |
Default |
Description |
| clientId |
header |
string |
required |
Client id |
| Authorization |
header |
string |
required |
Authorization token |
| operatorId |
body |
string |
required |
Operator id — a unique identifier assigned to the operator after merchant creation |
| currencyCode |
body |
string |
|
Currency code (eg., CNY, MYR) |
| requestId |
body |
string |
required |
Request ID for debugging purposes, the response will return the ID. |
Response:
| Parameter |
Type |
Default |
Description |
| operatorId |
string |
required |
Operator id — a unique identifier assigned to the operator after merchant creation |
| requestId |
string |
required |
Request ID for debugging purposes, the response will return the ID. |
| walletBalance |
array of walletBalance |
required |
|
POST
Synchronize player betting records.
Request:
| Parameter |
Location |
Type |
Default |
Description |
operatorId
versionNo |
|
|
|
| clientId |
header |
string |
required |
Client id |
| Authorization |
header |
string |
required |
Authorization token |
| startdate |
body |
date |
required |
Start dateFormat: yyyy-mm-dd hh:ii:ss |
| enddate |
body |
date |
required |
End dateFormat: yyyy-mm-dd hh:ii:ss |
| requestId |
body |
string |
required |
Request ID for debugging purposes, the response will return the ID. |
| playerName |
body |
string |
|
Player name Format: /[A-Za-z0-9.\/,_-]+/Length: 2 - 32 |
page pageNum |
body |
integer |
|
Page number. Default value is 1. |
perPage size |
body |
integer |
|
Items per request. Default value is 50. |
| providerId |
body |
string |
|
Game provider's id |
Response:
| Parameter |
Type |
Default |
Description |
currentPage pageNum |
integer |
required |
Currenct page |
totalPages totalPage |
integer |
required |
Total pages |
| itemsPerPage |
integer |
required |
Items per page |
totalCount total |
integer |
required |
Total count |
| requestId |
string |
required |
Request ID for debugging purposes, the response will return the ID. |
| betsList |
array of betsList |
required |
POST
Retrieves a snapshot of the player's current betting records.
Request:
| Parameter |
Location |
Type |
Default |
Description |
operatorId |
|
|
|
| clientId |
header |
string |
required |
Client id |
| Authorization |
header |
string |
required |
Authorization token |
| orderNo |
body |
string |
required |
Order No |
| requestId |
body |
string |
required |
Request ID for debugging purposes, the response will return the ID. |
Response:
| Parameter |
Type |
Default |
Description |
| requestId |
string |
required |
Request ID for debugging purposes, the response will return the ID. |
| url |
string |
required |
Result snapshot URL |
POST
Retrieves bet details based on a specific order number.
Request:
| Parameter |
Location |
Type |
Default |
Description |
operatorId |
|
|
|
| clientId |
header |
string |
required |
Client id |
| Authorization |
header |
string |
required |
Authorization token |
| orderNo |
body |
string |
required |
Order No |
| requestId |
body |
string |
required |
Request ID for debugging purposes, the response will return the ID. |
Response:
| Parameter |
Type |
Default |
Description |
versionNo |
|
|
|
| orderNo |
string |
required |
Order No |
| gfOrderNo |
string |
required |
GP Order No |
| playerName |
string |
required |
Player name Format: /[A-Za-z0-9.\/,_-]+/Length: 2 - 32 |
| opPlayerName |
string |
required |
OP Player name |
| operatorId |
integer(int64) |
required |
Operator ID (unique numeric identifier of the operator).Format: /^[0-9]+$/Length: 19 |
| operatorName |
string |
required |
Operator name |
| providerId |
string |
required |
Provider id |
| providerCode |
string |
required |
Provider code |
| providerMerchant |
string |
required |
Provider merchant |
| providerName |
string |
required |
Provider name |
| leagueNo |
string |
required |
League No |
| leagueNoId |
string |
required |
League No Id |
| gameName |
string |
required |
Game name |
| gameNameEn |
string |
required |
Game name in english |
| gameCode |
string |
required |
Game code |
| gameType |
string |
required |
Game Type (eg., SLOT | LIVE) |
| gameLobbyType |
string |
required |
Game Lobby Type |
| playBalanceBefore |
decimal |
required |
Player's balance before the transaction. |
| betAmount |
decimal |
required |
Bet amount |
| winLoseAmount |
decimal |
required |
Win/Loss amount — positive for profit, negative for loss. |
| settleAmount |
decimal |
required |
Payout amount |
| playBalanceAfter |
decimal |
required |
Player's balance after the transaction. |
| validBet |
decimal |
required |
Valid bet |
| betDate |
date |
required |
Bet dateFormat: yyyy-mm-dd |
| betTime |
date |
required |
Bet timeFormat: yyyy-MM-dd hh:mm:ss
|
| settleTime |
string |
required |
Settle timeFormat: yyyy-MM-dd hh:mm:ss |
| syncTime |
string |
required |
Sync timeFormat: yyyy-MM-dd hh:mm:ss |
currencyCode currency |
string |
required |
Currency code |
| jackpotRtpContributionAmount |
string |
required |
Player's contribution amount to the jackpot return rate. |
| jackpotContributionAmount |
string |
required |
Player's jackpot contribution amount. |
| jackpotWinAmount |
string |
required |
Player's jackpot amount. |
| gameResult |
string |
required |
Game result (eg., WIN | LOSS) |
| requestId |
string |
required |
Request ID for debugging purposes, the response will return the ID. |
| betSlip |
string |
required |
Bet slip |
| Parameter |
Type |
Default |
Description |
| providerId |
string |
required |
Game provider's id |
| playerId |
string |
required |
Operator user's unique identifier |
| playerName |
string |
required |
Player name Format: /[A-Za-z0-9.\/,_-]+/Length: 2 - 32 |
| currencyCode |
string |
required |
Currency code (eg., CNY, MYR) |
| balance |
decimal |
required |
Current balance |
| Parameter |
Type |
Default |
Description |
| currencyCode |
string |
required |
Currency code (eg., CNY, MYR) |
| balance |
decimal |
required |
Operator balance |
| Parameter |
Type |
Default |
Description |
| providerId |
string |
required |
Provider id |
| providerName |
string |
required |
Provider name |
| gameId |
string |
required |
Game id |
| gameName_ZH |
string |
required |
Game name in chinese |
| gameName_EN |
string |
required |
Game name in english |
| gameIntroduction |
string |
required |
Game introduction |
| gameType |
string |
required |
Game type |
| walletType |
string |
required |
Wallet type |
| releaseDate |
datetime |
required |
Release date |
| limits |
limits |
required |
| features |
features |
required |
| jackpots |
array of jackpots |
required |
| totalBetMultiplier |
integer |
required |
Total bet multiplier |
| Parameter |
Type |
Default |
Description |
| maxTotalStake |
integer |
required |
Maximum total stake per game round |
| stakeDef |
integer |
required |
Default stake amount |
| stakeMax |
integer |
required |
Maximum single stake allowed |
| stakeMin |
integer |
required |
Minimum single stake required
|
| winMax |
integer |
required |
Maximum win allowed per round
|
| Parameter |
Type |
Default |
Description |
| isFreebetSupported |
boolean |
required |
Indicates if free bet mode is supported |
| isMultibet |
boolean |
required |
Supports placing multiple bets at once |
| isDemoSupported |
boolean |
required |
Supports demo (free play) mode |
| isJackpotSupported |
boolean |
required |
Indicates whether the game includes jackpot functionality |
| baseRTP |
decimal |
required |
Base Return to Player percentage |
| highestPrizeProbability |
integer |
required |
Chance (in %) of highest prize appearing in a spin |
| baseRTPRange |
object |
required |
Range of possible base RTP values{"min": 90.42, "max": 93.52} |
| jpRTP |
decimal |
required |
Jackpot Return to Player percentage |
| gameFinalizationType |
string |
required |
Indicates the finalization type of the game round (e.g., none, auto) |
| featuresRTP |
object |
required |
Breakdown of RTPs across game modes (e.g., mode1, freeGames) |
| Parameter |
Type |
Default |
Description |
| currencyCode |
string |
required |
Currency associated with the jackpot entry (e.g., USD, CNY) |
| id |
string |
required |
Unique identifier for the jackpot pool |
| Parameter |
Type |
Default |
Description |
| providerId |
string |
required |
Game provider's id |
| playerId |
string |
required |
Operator user's unique identifier |
| playerName |
string |
required |
Player name Format: /[A-Za-z0-9.\/,_-]+/Length: 2 - 32 |
| online |
string |
required |
Online status (eg., online | offline) |
| Parameter |
Type |
Default |
Description |
| providerId |
string |
required |
Game provider's id |
| playerId |
string |
required |
Operator user's unique identifier |
| playerName |
string |
required |
Player name Format: /[A-Za-z0-9.\/,_-]+/Length: 2 - 32 |
| currencyCode |
string |
required |
Currency code (eg., CNY, MYR) |
| balance |
decimal |
required |
Current balance |
| Parameter |
Type |
Default |
Description |
versionNo |
|
|
|
| id |
string |
required |
ID |
| serialNo |
integer(64) |
required |
Serial number used for pagination and sorting. |
| orderNo |
string |
required |
Order No |
| gfOrderNo |
string |
required |
GP Order No |
| playerName |
string |
required |
Player name Format: /[A-Za-z0-9.\/,_-]+/Length: 2 - 32 |
| opPlayerName |
string |
required |
OP Player name |
| operatorId |
integer(int64) |
required |
Operator ID (unique numeric identifier of the operator).Format: /^[0-9]+$/Length: 19 |
| operatorName |
string |
required |
Operator name |
| providerCode |
string |
required |
Provider code |
| providerMerchant |
string |
required |
Provider merchant |
| providerName |
string |
required |
Provider name |
| leagueNo |
string |
required |
League No |
| leagueNoId |
string |
required |
League No Id |
| gameName |
string |
required |
Game name |
| gameNameEn |
string |
required |
Game name in english |
| gameCode |
string |
required |
Game code |
| gameType |
string |
required |
Game Type (eg., SLOT | LIVE) |
| gameLobbyType |
string |
required |
Game Lobby Type |
| playBalanceBefore |
decimal |
required |
Player's balance before the transaction. |
| betAmount |
decimal |
required |
Bet amount |
| winLoseAmount |
decimal |
required |
Win/Loss amount — positive for profit, negative for loss. |
| settleAmount |
decimal |
required |
Payout amount |
| playBalanceAfter |
decimal |
required |
Player's balance after the transaction. |
| validBet |
decimal |
required |
Valid bet |
| betDate |
date
| required |
Bet dateFormat: yyyy-mm-dd |
| betTime |
date |
required |
Bet timeFormat: yyyy-MM-dd hh:mm:ss |
| settleTime |
string |
required |
Settle timeFormat: yyyy-MM-dd hh:mm:ss |
| syncTime |
string |
required |
Sync timeFormat: yyyy-MM-dd hh:mm:ss |
currencyCode currency |
string |
required |
Currency code |
| jackpotRtpContributionAmount |
string |
required |
Player's contribution amount to the jackpot return rate. |
| jackpotContributionAmount |
string |
required |
Player's jackpot contribution amount. |
| jackpotWinAmount |
string |
required |
Player's jackpot amount. |
| gameResult |
string |
required |
Game result (eg., WIN | LOSS) |
| betSlip |
string |
required |
Bet slip |