Table of contents

• Overview

Architecture

• Bonus Lifecycle & Chunk Model

• Configuration Hierarchy

Integration Flows

• Promo Code Sync, Validation & Bonus Grant

• Wager-Based Chunk Release

• Bonus Consumption & Reversal

• Expiry, Forfeit & Reconciliation

API Reference

• Conventions & Authentication

• User Bonus API (Player & S2S)

• Configuration APIs (Admin)

• Bonus Events

Webhooks

• Bonus Wallet Update Webhook

Operations

• Non-Functional Requirements & Failure Handling