Wallet Integration
Introduction
When integrating ThrillPots to your wallet, you will need to implement what is known as the "Standard Wallet API". This API has been defined by ThrillTech and is what our ThrillGate services uses to communicate with your backend to process:
- Player Authentication
- Transactions
- Transaction cancellations
- Batch transactions# Wallet Integration
ThrillPots Wallet Configuration
IMPORTANT
Please note that when you change the wallet configuration for the ThrillPots service, you MUST restart the ThrillPots service for the changes to take effect. In this section, we will discuss how ThrillPots performs player authentication and jackpot contribution transactions.
When running in a non-development environment (such as staging or production), ThrillPots uses the ThrillGate Service as an integration layer to an operator's wallet API.
NOTE:
ThrillPots also supports an internal, in-memory wallet for development or isolated testing purposes. This wallet is enabled by default in the AIO development container
Types of Wallet Integrations
There are two types of wallet integrations that can be developed:
- Provider-to-Operator integration
- Operator-to-Provider integration (Standard Wallet Integration)
This section is been written for operators that have chosen to do an Operator-to-Provider
integration. For a Provider-to-Operator integration, ThrillTech are responsible for implementing the integration to your wallet API and that topic is out of scope for this book.
- Batch transaction cancellations
All communications from ThrillGate are conducted over secure SSL REST calls to your system.
As part of all calls to your system, ThrillGate sends an HMAC in the X-Server-Authorization
header which is calculated from the body of the request only. You can use this HMAC value to verify that the request is coming from the expected ThrillGate server.
NOTE: During integration you will receive the secret key that you can use to verify the HMAC value with.