Verticals
iGaming
Brands, players and activities, NGR formulas, CPA and revshare commission plans, sub-affiliates, monthly commission runs and ledger posting.
The iGaming suite measures players rather than clicks: an affiliate is paid on the players they refer, using the operator's own numbers. It sits on the same partners, offers, ledger and portals, so iGaming payouts appear on the same statements as everything else.
Model
| Object | Purpose |
|---|---|
| Brand | An operator or casino site. Holds the NGR formula, the S2S token and the offer that referred players are attributed under. |
| Player | A registered customer of a brand, linked to the affiliate click that brought them. |
| Activity | One of deposit, withdrawal, bet, win, bonus, chargeback, fee. Activities roll up to player-per-day metrics. |
| Plan | A commission plan: cpa, revshare or hybrid. |
| Deal | Assigns a plan to an affiliate (or a default), per brand. |
| Run | A monthly commission calculation per brand: preview, approve, post. |
| Affiliate tree | Optional parent for each affiliate, for sub-affiliate commissions. |
| Promo codes, creative approvals | Codes tied to partners and a review step for brand-sensitive creatives. |
Getting data in
- Server-to-server: operators post players and activities to the public S2S endpoint with the brand token,
POST /v1/igaming/s2s/{tenant}/{brand}(JSON or form body). Rotate the token withPOST /igaming/brands/{id}/s2s-token; it is shown once. - Bulk:
POST /igaming/ingest(JSON) andPOST /igaming/uploads(CSV of players or activities, multipart withbrand_id,kind,file). - Links and clicks work as for any offer: the player is registered with the partner's
click_id, and conversions such as registration and first deposit can also be reported through the normal postback.
SFTP fetch of operator reports is not built; use the CSV upload or the S2S endpoint.
NGR
Net gaming revenue is computed per brand from its formula and summed from daily rows, so daily and monthly numbers always agree:
GGR = stakes - wins
NGR = GGR - bonuses - admin_fee_pct% x GGR - tax_pct% x GGR - chargebacks - fees
Each deduction can be switched on or off per brand (deduct_bonuses, deduct_chargebacks, deduct_fees; admin_fee_pct and tax_pct default to 0). Percentage deductions are linear in GGR, so a losing day yields a credit. After changing a formula, POST /igaming/brands/{id}/rebuild recomputes the player metrics.
Plans
CPA pays a fixed amount per qualified player: the player must deposit at least min_deposit and wager at least min_wager within within_days of the first deposit, optionally from allowed countries and with require_kyc. The qualification moment is recorded per player.
Revshare pays a percentage of the affiliate's monthly NGR, in tiers:
| Setting | Effect |
|---|---|
metric | ngr (tiers by monthly NGR) or players (tiers by active players). |
tier_mode | highest: the rate of the highest reached tier applies to the whole base. marginal (NGR only): each band's rate applies to its slice. |
tiers | from threshold and percent per rung. |
Hybrid combines both. Revshare is charged on max(NGR + carry-in, 0). If an affiliate's month is negative the deficit can carry forward to the next month (KeepNegative) or be forgiven, using the same rollover rules as customer-value payouts. A pure CPA plan neither builds nor recovers a negative balance.
Sub-affiliates: a plan lists sub_affiliate_percents, the share a parent earns on level 1, level 2 and deeper descendants' commissions. Set a partner's parent with PUT /igaming/affiliate-tree/{partner_id}.
Monthly runs
POST /igaming/runspreviews the run for a brand and month: per affiliate, the qualified players, active players, NGR, carry-in, commission and carry-out, with line detail.- Review it in Insights, iGaming runs. A preview can be re-run or discarded (
POST /igaming/runs/{id}/discard). POST /igaming/runs/{id}/approveposts the per-affiliate deltas to the ledger as balanced journals with idempotency keys (ig:{run}:{line}), so approving twice is harmless and the amounts appear on the partners' statements.
Approving an earlier month does not re-run later months: carry-in for a month is read when it is previewed, so run months in order.
Reports and portals
Admin: brands, players, plans and deals, runs. Partners see their players and commissions under iGaming in the partner portal. Player and affiliate summaries show registrations, first-time depositors (FTDs), deposits, GGR and NGR per player, affiliate and brand, and each run shows qualified players and commission.
The RBAC for iGaming reuses the offers, reports and billing permissions.