Download OpenAPI specification:Download
The ThrillGate Wallet API provides a standarised API interface for wallets and operator platforms to expose to enable player authentication and wallet operations to be performed on behalf of players.
Prior to making any wallet calls on behalf of the player, the player's session token that was received by the gaming system needs to be authenticated using this call.
| operator_id required | string The operator ID for the auth request |
| brand_id required | string The brand ID for the auth request |
| player_token required | string The player's session token for the auth request |
| source_id | string or null The source of any future bets from this player in this session This is usually a game code, but can be any unique identifier that the operator has configured to be the source of wagers |
| currency required | string The currency that the player will be wagering in for this game session |
{- "operator_id": "string",
- "brand_id": "string",
- "player_token": "string",
- "source_id": "string",
- "currency": "string"
}{- "id": "string",
- "token": "string",
- "currency": "string",
- "balance": 0.1,
- "operator_id": "string",
- "brand_id": "string",
- "nickname": "string",
- "gender": "string",
- "country": "string",
- "jurisdiction": "string",
- "segments": [
- "string"
]
}Use this call to cancel a historical Debit or Credit transaction.
| transaction_id required | string |
| player_id | string or null |
{- "transaction_id": "string",
- "player_id": "string"
}{- "balance": "string"
}This endpoint can be used to either Credit or Debit a player's account.
Debit refers to removing money from a player's wallet (for a bet)
Credit refers to adding money to a player's wallet (for a win)
| player_id required | string The player's ID on the operator's wallet/account system |
| transaction_id required | string The transaction ID for the Debit/Credit |
| transaction_type required | string (TransactionType) Enum: "None" "Debit" "Credit" |
| provider_id required | string The provider identifier (eg 'thrilltech') |
| amount required | number <double> The amount that should be debited or credits from/to a player's account |
| jackpot_amount required | number <double> The amount from |
| source_id required | string The source of the transaction (could be game code, or jackpot identifier or any other predefined identifier) |
| source_variant | string or null A differentiator value for variants of the same game product |
| gameround_id required | string The gaming system's game round ID for the transaction |
| gameround_complete | boolean or null Indicator whether this transaction should close the game round |
| category | string or null (optional) Free text category indicator |
| channel | string or null (optional) Free text channel qualifier |
| promotion_id | string or null (optional) promotion ID that the bet is associated with. This will be populated if the transaction is making use of free spins or bonus funds defined in the operator's wallet/account system |
| promotion_type | string or null (optional) promotion type of the promotion (if any) |
| currency required | string Optional transaction currency indicator |
| metadata | any or null |
{- "player_id": "string",
- "transaction_id": "string",
- "transaction_type": "None",
- "provider_id": "string",
- "amount": 0.1,
- "jackpot_amount": 0.1,
- "source_id": "string",
- "source_variant": "string",
- "gameround_id": "string",
- "gameround_complete": true,
- "category": "string",
- "channel": "string",
- "promotion_id": "string",
- "promotion_type": "string",
- "currency": "string",
- "metadata": null
}{- "balance": 0.1,
- "metadata": null
}This endpoint can be used to issue a batch of either Credit or Debit transactions for multiple player accounts.
| batch_transaction_id required | string |
| transaction_type required | string (TransactionType) Enum: "None" "Debit" "Credit" |
| provider_id required | string |
| amount required | number <double> The total amount of all transactions in the |
| jackpot_amount required | number <double> The total jackpot amount of all transactions in the |
| source_id required | string |
| gameround_id | string or null |
| gameround_complete | boolean or null |
required | Array of objects (SWTransactionBatchRecord) |
| metadata | any or null |
{- "batch_transaction_id": "string",
- "transaction_type": "None",
- "provider_id": "string",
- "amount": 0.1,
- "jackpot_amount": 0.1,
- "source_id": "string",
- "gameround_id": "string",
- "gameround_complete": true,
- "transactions": [
- {
- "transaction_id": "string",
- "player_id": "string",
- "currency": "string",
- "amount": 0.1,
- "jackpot_amount": 0.1
}
], - "metadata": null
}{- "total_amount": 0.1,
- "total_jackpot_amount": 0.1,
- "errors": [
- {
- "player_id": "string",
- "code": "string",
- "msg": "string"
}
], - "metadata": null
}Use this call to cancel a historical batch Debit or Credit transaction.
| batch_id required | string |
| transaction_id_list required | Array of strings |
{- "batch_id": "string",
- "transaction_id_list": [
- "string"
]
}{- "success": true
}