Affiliate Management System (AFF modules)

Introduction

The affiliate management system (AFF module) allows partners to attract players and receive a commission from their activity. The AFF module built into the platform provides the generation of referral links, tracking of registrations and deposits, automatic calculation of rewards, multi-tier fee structure and detailed reporting.

1. Generating and tracking referral links

Unique tokens: 'affiliateId' and a set of referral links of the form are created for each partner

```
https: //casino. example. com/?aff=abc123
```
Cookie- and session-tracking: when clicking on a link in a cookie, 'aff = abc123' is saved on configurable TTL (30-90 days).
Server-side attribution: if the player registers outside the cookie period, fallback by IP and UTM advertising tags.

2. Fee calculation module

1. Types of rewards:
  • Revenue share: percentage of GGR (usually 20-40%).
  • CPA: fixed registration fee + first deposit.
  • HybrID: combination of CPA and RS.
  • 2. Multi-tier programs:
    • Tier 1: direct referrals.
    • Tier 2 +: reduced commission referrals (5-10%).
    • 3. Settlement period: daily/weekly/monthly depending on the agreement.
    • 4. Automation:
      • `POST /affiliate/compute? period = 2025-07 'starts job calculation.
      • ACID transactions: accrual in Ledger Service, creation of payout request.

      3. API and webhook integrations

      REST API:
      • `GET /affiliate/{id}/stats? from = & to = '→ of registration, deposits, GGR, commission.
      • 'POST/affiliate/{ id }/payout '→ create a payout for the specified details.
      • Webhooks:
        • Events: 'player. registered`, `player. deposited`, `affiliate. commission. awarded`.
        • Payload contains' affiliateId ',' playerId ', amounts and bets.

        4. Reporting and interfaces

        Partner dashboard:
        • Displays in real time: new players, deposit amounts, GGR, accrued commissions, payment status.
        • Filters by period, country, traffic source (UTM).
        • Export: CSV/PDF on schedule and on demand.
        • API access for BI: integration with external systems via secure REST.

        5. Anti-fraud and system protection

        Detection:
        • Blocking self-referral (same IP/device).
        • Velocity checks: more than N registrations per minute from one token.
        • Blacklist/Whitelist:
          • Admin panel for manual control.
          • Audit log:
            • Immutable recording of all tracking and calculation events in WORM storage.

            6. Scalability and fault tolerance

            Microservice architecture: AFF-Service separate from core, scaled by tracking load.
            Message Broker (Kafka):
            • Real-time processing of registration events and deposits.
            • Cache Layer (Redis):
              • Fast lookup 'affiliateId' by 'playerId' and UTM.
              • High Availability:
                • Kubernetes with HPA for AFF-Service and Leaderboard Service, Sentinel clusters Redis.

                7. Safety and compliance

                Authentication: OAuth2 for partners, API keys with IP restriction.
                Encryption: TLS for all channels, Vault storage of secrets.
                GDPR/CCPA: the right to delete partner and player data, the ability to anonymize.

                Conclusion

                The built-in affiliate management system provides partners with a full-fledged tool for attracting and monetizing traffic: from unique links and tracking to automatic calculation of multi-tier commissions, real-time dashboards and reliable protection against fraud. Scalable microservice architecture and API integrations ensure partner network growth without sacrificing performance and security.