Events for the bonus lifecycle.
bonus_awarded
Example Payload
{
"event": "bonus_awarded",
"timestamp": "2025-07-18T14:07:03Z",
"user_id": "user123",
"value": {
"bonus_id": "BN789012345",
"qualifying_type": "deposit_match",
"items":
[
{
"nature": "casino",
"bonus_name": "50 free spins",
"bonus_code": "WELCOME50",
"amount": 0.00,
},
{
"nature": "deposit",
"bonus_name": "50% matched",
"bonus_code": "MATCH50",
"amount": 100.00,
}
]
"balance_cash": 500.00,
"balance_bonus": 100.00,
"balance_total": 600.00
}
}
bonus_expired
Example Payload
{
"event": "bonus_expired",
"timestamp": "2025-07-18T14:07:03Z",
"user_id": "user123",
"value": {
"bonus_id": "BN789012345",
"qualifying_type": "deposit_match",
"expiry_reason": "time_limit_reached",
"expired_amount": 100.00,
"items":
[
{
"nature": "casino",
"bonus_name": "50 free spins",
"bonus_code": "WELCOME50",
"amount": 0.00,
"status": "expired"
},
{
"nature": "deposit",
"bonus_name": "50% matched",
"bonus_code": "MATCH50",
"amount": 100.00,
"status": "expired"
}
]
"balance_cash": 500.00,
"balance_bonus": 0.00,
"balance_total": 500.00
}
}
bonus_used
Example Payload
{
"event": "bonus_used",
"timestamp": "2025-07-19T19:10:04Z",
"user_id": "user123",
"value": {
"bonus_id": "BN789012345",
"product": "Casino",
"qualifying_type": "deposit_match",
"bonus_name": "50% matched",
"bonus_code": "MATCH50",
"amount_used": 20.00,
"remaining_amount": 80.00,
"balance_cash": 500.00,
"balance_bonus": 80.00,
"balance_total": 580.00
}
}