Bonus
The bonus event will give you the ability to see actual bonus costs associated to your campaigns. It will also allow you to trigger activities on bonus status changes, e.g. if it's lost too quickly.
REST API
RabbitMQ Connector
Kafka Connector
⬆️ POST /v1/integration/bonus
RabbitMQ Message Properties
key | value |
type | BONUS |
The type is expected as a property (but not in the payload) of the RabbitMQ Message. Any header will be ignored.
Kafka Message Headers
key | value |
type | BONUS |
Request
It's important that only one event is sent when the status of the bonus is changed.
Multiple events of the same status will result in the segmentation data being incorrect.
When sending 'free spins' bonuses, we expect the first bonus event to be sent once the free spins rounds have been completed and with the correlating "amount" that was won.
If you wish to send data when the free spins has been issued, you might send this as a 'Custom Event'.
Required properties are marked with *
Key | Type | Description |
amount * | float | The amount assigned to the bonus. |
bonus_code | string | Indication as to the nature of the promotion eg “WELCOME100” |
bonus_id * | string | Unique identifier for each bonus campaign. |
bonus_turned_real | float | Bonus amount turned to real money, if wagering is finished |
currency * | string
Format: ISO4217 | Player currency |
exchange_rate * | float | The exchange rate at the timestamp |
locked_amount | float | Bonus amount locked to wagering |
meta | object | If meta data is required to be sent |
origin * | string | This value can be used to identify the brand or jurisdiction the player is playing on |
product * | string
Accepted Values:
"Casino"
"Sportsbook"
"Lotto"
"Poker" | Defines the product associated to the bonus |
required_wagering_amount | float | Required wagering amount of bonus |
status * | string
Accepted Values:
"Pending"
"Created"
"Ongoing"
"Completed"
"AutoCompleted"
"Forfeited"
"Expired"
"Lost"
"Reversed" | The status assigned to the bonus at the moment of the real time event being sent. |
timestamp * | string
Format: RFC3339 | Timestamp of the event being sent. |
type * | string
Accepted Values: "NoDeposit"
"WelcomeBonus"
"CashbackBonus"
"ReloadBonus" "WagerFree"
"FreeSpins" "RiskFreeBet" "Undefined" | Has to be one of the specificied values in the list. If not, please send "Undefined". We can assist on mapping your current bonus types to the list defined here. |
user_bonus_id * | string | Unique identifier of the bonus credited to a player. Can be set as a random value, suggestion is to be user id + bonus id. |
user_id * | string | User id of the player the bonus has been credited to. |
fasttrack_references | object | Data provided by Fast Track on any bonus crediting requests.
Read more about the implementation here. |
Status descriptions
Status | Description |
Pending | When a bonus has been given to the player but not yet been claimed. |
Created | When the bonus has been claimed and the funds are added to the player’s account. |
Ongoing | When wagering has started by the user. e.g. player places the first bet with the bonus funds.
*This event can be sent multiple times to track how the player progresses with the wagering requirement. |
Completed | If the wagering requirement is fulfilled and the bonus funds are turned into real funds. |
AutoCompleted | If your system automatically removes the bonus with a general setting.
e.g. Bonuses are autocompleted if the balance reaches under €0.10 |
Forfeited | If the bonus has been forfeited. |
Expired | If the validity period of the bonus has expired. |
Lost | If the player has run out of bonus balance. |
Reversed | When a previously active bonus has been credited back to the player’s account, usually when there’s a canceled withdrawal. |