@fundedfast/sdk 1.5.0 → 3.0.0

package/dist/cjs/types.d.ts

@@ -16,12 +16,22 @@ export type BetStatus = 'placed' | 'settled-won' | 'settled-lost' | 'voided';
 export type ValidationStatus = 'accepted' | 'rejected' | 'flagged';
 /** Funded account lifecycle state */
 export type FundedAccountStatus = 'active' | 'revoked' | 'closed';
+/** Why a funded account is closing: its lifetime ended, or it was inactive too long. */
+export type FundedClosingReason = 'expired' | 'inactivity';
 /** Webhook delivery state */
 export type WebhookDeliveryStatus = 'pending' | 'delivered' | 'failed';
 /** Tenant integration mode */
 export type IntegrationMode = 'sync' | 'async';
 /** All possible rejection reason codes from the rules engine */
-export type RejectionCode = 'min_stake_not_met' | 'max_stake_exceeded' | 'odds_limit_exceeded' | 'min_odds_not_met' | 'max_payout_exceeded' | 'max_selections_exceeded' | 'max_win_exceeded' | 'lucky_bet_profit_limit' | 'daily_drawdown_exceeded' | 'max_drawdown_exceeded' | 'cooldown_active' | 'payout_pending' | 'cashout_not_allowed_during_challenge'
+export type RejectionCode = 'min_stake_not_met' | 'max_stake_exceeded' | 'odds_limit_exceeded' | 'min_odds_not_met' | 'max_payout_exceeded' | 'max_selections_exceeded'
+/** Stake x odds above the ruleset's maxTicketPayout (stake included). */
+ | 'max_ticket_payout_exceeded'
+/** Stake above the visible balance (ledger balance less open stake). */
+ | 'insufficient_balance' | 'lucky_bet_profit_limit' | 'max_drawdown_exceeded'
+/** New tickets are paused by the session stop (daily drawdown). */
+ | 'cooldown_active' | 'payout_pending'
+/** The funded account is closing (time up or inactive): no new tickets. */
+ | 'account_closing' | 'cashout_not_allowed_during_challenge'
 /** Settlements only. A won/lost after a different result for the same bet: held for an operator, no balance change. */
  | 'conflicting_settlement'
 /** Settlements only. Stake or odds differ from the accepted placement, or the payout exceeds stake x odds: held, no balance change. */
@@ -29,17 +39,17 @@ export type RejectionCode = 'min_stake_not_met' | 'max_stake_exceeded' | 'odds_l
 /** Settlements only. FAST never accepted this bet (rejected, or placed with no programme). Recorded, no balance change. */
  | 'no_accepted_placement'
 /** Settlements only. Accepted on a programme that has closed since, typically a challenge that passed with the bet still open. Recorded under that programme, no balance change. */
- | 'program_closed';
+ | 'program_closed'
+/** The challenge or funded account names a ruleset FAST cannot load: no ticket is accepted until the operator fixes the tier. */
+ | 'ruleset_unavailable';
 /** Webhook event types emitted by FAST */
-export type WebhookEventType = 'challenge.activated' | 'challenge.passed' | 'challenge.completed' | 'challenge.failed' | 'challenge.cancelled' | 'challenge.expiring_soon' | 'challenge.stake_refunded' | 'challenge.bonus_voided' | 'funded_account.activated' | 'funded_account.revoked' | 'funded_account.payout' | 'funded_account.stake_refunded' | 'funded_account.payout_requested' | 'funded_account.payout_rejected' | 'cooldown.triggered' | 'cooldown.lifted' | 'bet.validation_result' | 'achievement.earned' | 'reward.granted' | 'reward.applied' | 'user.self_excluded' | 'user.self_exclusion_lifted' | 'bonus.activated' | 'bonus.progress' | 'bonus.completed' | 'bonus.expired' | 'bonus.forfeited' | 'mission.enrolled' | 'mission.progress' | 'mission.completed' | 'mission.expired' | 'tournament.started' | 'tournament.user_joined' | 'tournament.user_invited' | 'tournament.settled' | 'tournament.cancelled' | 'loyalty.tier_upgraded' | 'loyalty.tier_downgraded' | 'loyalty.cashback_settled' | 'reward.expired';
+export type WebhookEventType = 'challenge.activated' | 'challenge.passed' | 'challenge.completed' | 'challenge.failed' | 'challenge.cancelled' | 'challenge.expiring_soon' | 'challenge.stake_refunded' | 'challenge.bonus_voided' | 'funded_account.activated' | 'funded_account.revoked' | 'funded_account.inactivity_warning' | 'funded_account.closing' | 'funded_account.closed' | 'funded_account.payout_debt' | 'funded_account.payout' | 'funded_account.stake_refunded' | 'funded_account.payout_requested' | 'funded_account.payout_rejected' | 'cooldown.triggered' | 'cooldown.lifted' | 'bet.validation_result' | 'achievement.earned' | 'reward.granted' | 'reward.applied' | 'user.self_excluded' | 'user.self_exclusion_lifted' | 'bonus.activated' | 'bonus.progress' | 'bonus.completed' | 'bonus.expired' | 'bonus.forfeited' | 'mission.enrolled' | 'mission.progress' | 'mission.completed' | 'mission.expired' | 'tournament.started' | 'tournament.user_joined' | 'tournament.user_invited' | 'tournament.settled' | 'tournament.cancelled' | 'loyalty.tier_upgraded' | 'loyalty.tier_downgraded' | 'loyalty.cashback_settled' | 'reward.expired';
 /** Body for POST /challenges/purchase */
 export interface PurchaseRequest {
     /** Your sportsbook user identifier */
     userId: string;
     /** UUID of the challenge tier to purchase */
     challengeTierId: string;
-    /** ISO 8601 timestamp (defaults to server time) */
-    timestamp?: string;
     /** Optional affiliate/referral tracking code */
     referralCode?: string;
 }
@@ -68,55 +78,94 @@ export interface BetEvent {
 }
 /** Body for POST /users/:userId/withdraw */
 export interface WithdrawRequest {
-    /** Amount to pay out. Must be <= withdrawable and >= the minimum payout. Ignored on the last allowed payout, which is always the full available amount. */
-    amount?: number;
+    /**
+     * Gross virtual profit to take off the balance, in whole cents, between
+     * `payout.minGrossAmount` and `payout.withdrawableGross`. The user is paid
+     * profitSplitPercent of it, rounded down to the cent. Required on every
+     * payout but the last allowed one (`payout.isFinal`), which always takes the
+     * whole gross profit: there it may be omitted.
+     */
+    grossAmount?: number;
     /** Leave the request pending for a later confirm/reject instead of executing it now. */
     deferred?: boolean;
 }
 /** Why a payout is not possible yet. Every reason that applies is listed. */
 export interface PayoutReason {
-    code: 'account_not_active' | 'payout_pending' | 'max_payouts_reached' | 'no_profit' | 'insufficient_active_days' | 'insufficient_bets' | 'below_min_payout' | 'payout_interval' | 'open_bets';
-    /** False when the reason only keeps the cycle share out and unpaid profit can still be requested. */
+    code: 'account_not_active' | 'payout_pending' | 'max_payouts_reached' | 'no_profit' | 'below_min_payout' | 'payout_interval' | 'open_bets' | 'payout_debt' | 'profit_held' | 'first_payout_below_stake';
+    /**
+     * Whether this reason stops a request. `open_bets` on the last payout does
+     * not: only its execution waits. `profit_held` blocks only the last payout,
+     * or an account with no matured profit.
+     */
     blocking: boolean;
     current?: number;
     required?: number;
     missing?: number;
+    /** below_min_payout: the gross amount whose share reaches the minimum. */
+    requiredGross?: number;
     until?: string;
 }
 export interface PendingPayout {
     id: string;
+    /** The user's share. */
     amount: number;
-    fromUnpaid: number;
-    fromCycle: number;
+    /** Gross virtual profit the payout takes off the balance; `amount` is the user's split of it. */
+    grossAmount: number;
     isFinal: boolean;
     isMandatory: boolean;
     createdAt: string;
 }
-/** Payout state of a funded account (the per-cycle model). */
+/**
+ * Payout state of a funded account. The user takes part of the gross virtual
+ * profit (virtual balance above the funded amount); their share is
+ * profitSplitPercent of it and exactly that gross amount leaves the balance.
+ * All of it is virtual until a payout executes.
+ */
 export interface PayoutState {
     currentBalance: number;
+    /** currentBalance minus the stake of open bets. */
+    virtualBalance: number;
     fundedAmount: number;
     profitSplitPercent: number;
-    cycleProfit: number;
-    cycleShare: number;
-    /** Already split, not yet paid. Not part of the balance, never split again. */
-    unpaidProfit: number;
+    /** Virtual balance above the funded amount, held part included. Not money owed to anyone yet. */
+    grossProfit: number;
+    /** Part of grossProfit from wins inside the operator's settlement hold: no payout may take it yet. */
+    heldProfit: number;
+    /** When the profit held now is all free to pay out. Null when nothing is held. */
+    heldUntil: string | null;
+    /**
+     * Shortfall below the funded amount that a void opened after an executed
+     * payout, up to the gross paid out. Later profit repays it before any payout
+     * opens; written off if the account ends first.
+     */
+    payoutDebt: number;
+    /** The user's split of grossProfit. */
+    profitShare: number;
+    /** Largest share a payout may take after caps, whether or not a condition blocks it now. */
     available: number;
+    /** Gross amount behind `available`. */
+    availableGross: number;
+    /** Share the user can request right now: `available`, or 0 while any reason blocks. */
     withdrawableNow: number;
-    activeDays: number;
-    minActiveDays: number;
-    cycleBets: number;
-    minBets: number;
-    conditionsMet: boolean;
+    /** Largest `grossAmount` a request may send right now: `availableGross`, or 0 while any reason blocks. */
+    withdrawableGross: number;
+    /** Smallest gross amount a request may take: the minimum payout grossed up, and on the first payout at least the own stake. */
+    minGrossAmount: number;
+    /** End of the account's lifetime. Null = no end. */
+    expiresAt: string | null;
+    /** Why the account is closing: no new tickets, open ones settle, then the profit left is paid in a final payout. Null while not closing. */
+    closingReason: FundedClosingReason | null;
     payoutCount: number;
     maxPayouts: number | null;
     remainingPayouts: number | null;
+    /** The last allowed payout, or any payout while the account is closing. */
     isFinal: boolean;
     minPayout: number | null;
     payoutIntervalDays: number | null;
     lastPayoutAt: string | null;
     nextPayoutAt: string | null;
-    mandatoryPayoutThreshold: number | null;
+    /** Gross profit at which a payout of this gross amount is created on its own. Null = none. */
+    mandatoryPayoutAmount: number | null;
     totalWithdrawn: number;
     openStake: number;
     pending: PendingPayout | null;
@@ -127,9 +176,10 @@ export interface PayoutRequest {
     id: string;
     fundedAccountId: string;
     userId: string;
+    /** The user's share. */
     amount: number;
-    fromUnpaid: number;
-    fromCycle: number;
+    /** Gross virtual profit taken off the balance; `amount` is the user's split of it. */
+    grossAmount: number;
     isFinal: boolean;
     isMandatory: boolean;
     status: 'pending' | 'executed' | 'rejected';
@@ -145,6 +195,80 @@ export interface PayoutRequest {
 }
 /** A payout request as the user's own list returns it: who decided it is not included. */
 export type UserPayoutRequest = Omit<PayoutRequest, 'decidedBy'>;
+/** One funded account in the operator overview. Every balance and profit figure is virtual. */
+export interface FundedAccountOverview {
+    id: string;
+    userId: string;
+    tierName: string | null;
+    status: 'active' | 'closed' | 'revoked';
+    revocationReason: string | null;
+    createdAt: string;
+    currency: string;
+    fundedAmount: number;
+    currentBalance: number;
+    virtualBalance: number;
+    grossProfit: number;
+    profitSplitPercent: number;
+    profitShare: number;
+    /** Share the user could request right now, every condition met; 0 otherwise. */
+    withdrawableNow: number;
+    canRequest: boolean;
+    /** Payout reason codes that currently stop a request. */
+    blockedBy: string[];
+    payoutCount: number;
+    maxPayouts: number | null;
+    remainingPayouts: number | null;
+    totalWithdrawn: number;
+    mandatoryPayoutAmount: number | null;
+    /** End of the account's lifetime. Null = no end. */
+    expiresAt: string | null;
+    /** Why the account is closing, and once closed why it ended. Null for an account that never closed this way. */
+    closingReason: FundedClosingReason | null;
+    openBets: number;
+    openStake: number;
+    /** Potential: stake x odds of open bets. Not a liability. */
+    openPotentialReturn: number;
+    pending: PendingPayout | null;
+    lastRequestStatus: 'pending' | 'executed' | 'rejected' | null;
+}
+export interface FundedAccountsOverview {
+    summary: {
+        activeAccounts: number;
+        /** Shares requestable now with every condition met. */
+        payableNow: number;
+        payableAccounts: number;
+        virtualGrossProfit: number;
+        virtualProfitShare: number;
+        pending: {
+            count: number;
+            amount: number;
+            grossAmount: number;
+        };
+        executed: {
+            count: number;
+            /** Users' shares paid. */
+            amount: number;
+            grossAmount: number;
+            operatorShare: number;
+            /** Own stakes returned with first payouts. */
+            ownStakeReturned: number;
+            /** Payout bonuses the operator paid on top. */
+            rewardBonus: number;
+            /** Everything paid out: shares, returned stakes and bonuses. */
+            totalPaid: number;
+        };
+        rejected: {
+            count: number;
+        };
+        open: {
+            bets: number;
+            stake: number;
+            potentialReturn: number;
+        };
+    };
+    accounts: FundedAccountOverview[];
+    truncated: boolean;
+}
 /** Result of confirming a payout request. */
 export interface PayoutExecution {
     payoutRequestId: string;
@@ -155,9 +279,10 @@ export interface PayoutExecution {
     /** userPayout + ownStakeReturned + rewardBonus */
     totalPayout: number;
     operatorShare: number;
+    /** Gross virtual profit taken off the balance (userPayout + operatorShare). */
+    grossAmount: number;
     newBalance: number;
-    unpaidProfit: number;
-    cycleClosed: boolean;
+    /** Share a cap kept from the last payout, which can no longer be paid. */
     forfeitedProfit: number;
     accountClosed: boolean;
 }
@@ -252,17 +377,23 @@ export interface ChallengeTier {
     profitSplitPercent: number;
     /** Min odds for bets */
     minOdds: number;
-    /** Max odds for bets */
-    maxOdds: number;
-    /** Max stake as % of balance */
-    maxStakePercent: number;
+    /** Max odds for bets. Null = no limit. */
+    maxOdds: number | null;
+    /** Max stake as % of balance. Null = no percentage limit. */
+    maxStakePercent: number | null;
+    /** Min stake as % of balance (the absolute minimum is 1). */
+    minStakePercent: number;
+    /** Cap on stake x odds per ticket, stake included. Null = no cap. */
+    maxTicketPayout: number | null;
+    /** Hours new tickets pause after the daily drawdown. Null = until the next local midnight. */
+    cooldownDurationHours: number | null;
     /** Max accumulator selections */
     maxAccumulatorSelections: number;
     /** Minimum bets to pass */
     minBetsRequired: number;
     /** Minimum active betting days */
     minActiveDays: number;
-    /** Daily loss limit as % of balance */
+    /** Session stop: % fall from the day's base balance that pauses new tickets. 0 = off. */
     dailyDrawdownPercent: number;
     /** Total drawdown limit as % of starting balance */
     totalDrawdownPercent: number;
@@ -285,26 +416,24 @@ export interface ChallengeTierFull {
     fundedAccountBalance: number;
     /** Profit split in user's favor (e.g. 80 = 80%) */
     profitSplitPercent: number;
-    /** Max payout as % of funded balance per cycle. null = no cap */
+    /** Max user share per payout, as % of the funded balance. null = no cap */
     payoutCapPercent: number | null;
-    /** @deprecated Decides nothing: every payout that includes the cycle share returns the balance to the funded amount. */
-    resetBalanceOnPayout: boolean;
-    fundedMinActiveDays: number;
-    fundedActiveDayPercent: number;
     /** Whether the user may take back the own stake during the funded phase. */
     fundedStakeRefundable?: boolean;
     /** Lifetime payout cap on the funded account. Null = none. */
     fundedTotalPayoutCap?: number | null;
-    /** Accepted bets required per payout cycle. */
-    fundedMinBets?: number;
     /** Most payouts the funded account allows. Null = no limit. */
     fundedMaxPayouts?: number | null;
-    /** Smallest payout that may be requested. Null = none. */
+    /** Smallest payout, measured on the user's share. Null = none. */
     fundedMinPayout?: number | null;
-    /** Days between payouts. Null = no interval. */
+    /** Days between payouts. Null = no gap. */
     fundedPayoutIntervalDays?: number | null;
-    /** Balance at which a payout becomes mandatory. Null = never. */
-    fundedMandatoryPayoutThreshold?: number | null;
+    /** Gross profit at which a payout of this gross amount is created on its own; the rest stays in play. Null = none. */
+    fundedMandatoryPayoutAmount?: number | null;
+    /** Lifetime of the funded account in days; then it closes with a final payout. Null = no end. */
+    fundedDurationDays?: number | null;
+    /** Days without activity after which the funded account closes with a final payout. Null = never. */
+    fundedInactivityDays?: number | null;
     /** ISO 4217 currency code */
     currency: string;
     enabled: boolean;
@@ -312,7 +441,7 @@ export interface ChallengeTierFull {
     updatedAt: string;
 }
 /** Body for creating a challenge tier: the fields the API requires, plus any optional ones. */
-export type ChallengeTierCreateRequest = Pick<ChallengeTierFull, 'name' | 'ownStake' | 'bonusAmount' | 'targetBalance' | 'durationDays' | 'challengeRulesetId' | 'fundedRulesetId' | 'fundedAccountBalance' | 'profitSplitPercent' | 'payoutCapPercent' | 'resetBalanceOnPayout' | 'fundedMinActiveDays' | 'fundedActiveDayPercent'> & Partial<Omit<ChallengeTierFull, 'id' | 'tenantId' | 'createdAt' | 'updatedAt'>>;
+export type ChallengeTierCreateRequest = Pick<ChallengeTierFull, 'name' | 'ownStake' | 'bonusAmount' | 'targetBalance' | 'durationDays' | 'challengeRulesetId' | 'fundedRulesetId' | 'fundedAccountBalance' | 'profitSplitPercent' | 'payoutCapPercent'> & Partial<Omit<ChallengeTierFull, 'id' | 'tenantId' | 'createdAt' | 'updatedAt'>>;
 /** Rules engine validation result */
 export interface ValidationResult {
     /** accepted = passes all rules, rejected = violates rules, flagged = accepted but noted */
@@ -324,29 +453,47 @@ export interface ValidationResult {
 export interface Ruleset {
     id: string;
     name: string;
-    maxStakePercent: number;
-    maxOdds: number;
+    /** Max stake as % of the reference balance. Null = no percentage limit. */
+    maxStakePercent: number | null;
+    /** Min stake as % of the reference balance (0..100). The absolute minimum stake is 1. */
+    minStakePercent?: number;
+    /** Null = no odds limit. */
+    maxOdds: number | null;
     minOdds: number;
     maxPayoutMultiplier: number;
     minBetsRequired: number;
     luckyBetMaxProfitPercent: number;
     luckyBetMaxOdds: number;
     minActiveDays: number;
+    /**
+     * Session stop: when the visible balance falls this % below the session
+     * base (the visible balance at the operator's local midnight), new tickets
+     * pause. 0 = off.
+     */
     dailyDrawdownPercent: number;
     totalDrawdownPercent: number;
+    /** Pause length in hours after the session stop. Null = until the next local midnight. */
     cooldownDurationHours: number | null;
+    /** Balance the stake percentages read, in both phases (default `current`). */
     balanceCalculationBasis?: 'original' | 'current';
     /** Max selections in an accumulator bet. 0 = no limit. */
     maxAccumulatorSelections?: number;
-    /** Absolute cap on potential win per ticket. Null = no cap. */
-    maxWinPerTicket?: number | null;
-    /** Basis for the daily drawdown calculation. */
-    sessionStopBasis?: 'original' | 'current';
+    /** Cap on stake x odds per ticket, stake included. Null = no cap. */
+    maxTicketPayout?: number | null;
     enabled?: boolean;
     tenantId?: string;
     createdAt?: string;
     updatedAt?: string;
 }
+/**
+ * The session stop line: the session base (visible balance at the operator's
+ * local midnight, re-based when a pause ends, lowered by an executed payout)
+ * and the visible balance at or below which new tickets pause.
+ */
+export interface SessionStop {
+    baseBalance: number;
+    limitBalance: number;
+}
 /** Live challenge progress for sportsbook UI */
 export interface ChallengeProgress {
     type: 'challenge';
@@ -367,6 +514,12 @@ export interface ChallengeProgress {
     cooldownUntil: string | null;
     /** Total stake amount in pending (unsettled) bets */
     reserved: number;
+    /** Cap on stake x odds per ticket, stake included. Null = no cap. */
+    maxTicketPayout?: number | null;
+    /** Session stop line for today. Null when the daily drawdown is off. */
+    sessionStop?: SessionStop | null;
+    /** Pause length in hours. Null = until the next local midnight. */
+    pauseHours?: number | null;
     currency?: string;
     selfExcluded?: boolean;
 }
@@ -392,8 +545,6 @@ export interface FundedAccountProgress {
     fundedAccountId: string;
     currentBalance: number;
     fundedAmount: number;
-    /** @deprecated Never returned by the API; always undefined. */
-    purchasePrice?: number;
     /** Own stake the user paid to enter. */
     ownStake?: number;
     /** Operator bonus: never withdrawable. */
@@ -411,23 +562,28 @@ export interface FundedAccountProgress {
     profitSplitPercent: number;
     payoutCapPercent: number | null;
     totalWithdrawn: number;
-    activeDays: number;
-    minActiveDays: number;
     status: 'active' | 'closed' | 'revoked';
     reserved: number;
     /** Stake on bets not yet settled. */
     openStake?: number;
     payoutCount?: number;
     maxPayouts?: number | null;
-    unpaidProfit?: number;
-    /** Accepted bets in the current payout cycle. */
-    totalBetsAccepted?: number;
-    /** Stake a day needs for it to count as an active day. */
-    activeDayThreshold?: number;
-    /** Stake placed today towards `activeDayThreshold`. */
-    todayWagered?: number;
-    minBetsRequired?: number;
-    maxWinPerTicket?: number | null;
+    /** Gross profit at which a payout is created on its own. Null = none. */
+    mandatoryPayoutAmount?: number | null;
+    /** End of the account's lifetime. Null = no end. */
+    expiresAt?: string | null;
+    /** Why the account is closing. Null while not closing. */
+    closingReason?: FundedClosingReason | null;
+    /** When inactivity would close the account if nothing happens before then. Null when not counting. */
+    closesAt?: string | null;
+    /** ISO 8601 end of the session stop pause, null when not paused. */
+    cooldownUntil?: string | null;
+    /** Session stop line for today. Null when the daily drawdown is off. */
+    sessionStop?: SessionStop | null;
+    /** Pause length in hours. Null = until the next local midnight. */
+    pauseHours?: number | null;
+    /** Cap on stake x odds per ticket, stake included. Null = no cap. */
+    maxTicketPayout?: number | null;
     payout?: PayoutState | null;
     /** Split points rewards added when this account opened (0 if none). */
     profitSplitRewardBoost?: number;
@@ -457,16 +613,18 @@ export interface WithdrawableInfo {
     fundedAmount: number;
     profitSplitPercent: number;
     payoutCapPercent: number | null;
-    activeDaysCount: number;
-    minActiveDays: number;
-    activeDaysMet: boolean;
     payout: PayoutState;
 }
 /** Payout request result. `executed` carries the profit split breakdown. */
 export interface WithdrawalResult {
     status: 'pending' | 'executed';
     payoutRequestId: string;
+    /** The user's share. */
     amount: number;
+    /** Gross virtual profit the payout takes off the balance. */
+    grossAmount: number;
+    /** The operator's share: grossAmount minus the user's share. */
+    operatorShare: number;
     isFinal: boolean;
     newBalance?: number;
     userPayout?: number;
@@ -474,9 +632,7 @@ export interface WithdrawalResult {
     /** Paid on top of userPayout from payout bonus rewards. */
     rewardBonus?: number;
     totalPayout?: number;
-    operatorShare?: number;
-    resetApplied?: boolean;
-    unpaidProfit?: number;
+    /** Share a cap kept from the last payout, which can no longer be paid. */
     forfeitedProfit?: number;
     accountClosed?: boolean;
 }
@@ -532,11 +688,12 @@ export interface SseToken {
 }
 /** The ruleset limits disclosed with a tier's terms. */
 export interface TierTermsRules {
-    maxStakePercent: number;
+    maxStakePercent: number | null;
+    minStakePercent: number;
     minOdds: number;
-    maxOdds: number;
+    maxOdds: number | null;
     maxPayoutMultiplier: number;
-    maxWinPerTicket: number | null;
+    maxTicketPayout: number | null;
     minBetsRequired: number;
     minActiveDays: number;
     dailyDrawdownPercent: number;
@@ -564,8 +721,6 @@ export interface TierTerms {
     rewardAccountBalance: number;
     profitSplitPercent: number;
     payoutCapPercent: number | null;
-    /** @deprecated Decides nothing: every payout that includes the cycle share returns the balance to the funded amount. */
-    resetBalanceOnPayout?: boolean;
     rules: TierTermsRules;
     /** Sentences to show the user before purchase, in `lang`. */
     disclosures: string[];
@@ -823,6 +978,8 @@ export interface TenantSettings {
     tenantId?: string;
     name?: string;
     environment?: string;
+    /** What the server API key may do: `integration` (all but /v1/admin/*) or `admin`. FAST changes it on request. */
+    apiKeyScope?: 'integration' | 'admin';
     integrationMode: IntegrationMode;
     webhookUrl: string | null;
     /** Single URL FAST calls before any money/irreversible action (type in payload). */
@@ -837,6 +994,8 @@ export interface TenantSettings {
     exportWebhookUrl?: string | null;
     defaultCurrency?: string;
     supportedCurrencies?: string[];
+    /** Operator IANA timezone (default Europe/Zagreb). Days and midnights are local to it. */
+    timezone?: string;
     widgetLayout?: {
         fundedOnly: boolean;
         history: boolean;
@@ -864,7 +1023,7 @@ export interface AdminOverview {
 }
 /** Bonus type */
 export type BonusType = 'deposit_match' | 'free_bet' | 'no_deposit' | 'cashback' | 'reload';
-/** Bonus offer (admin). Money fields are integer cents. */
+/** Bonus offer (admin). Money fields are EUR, whole cents. */
 export interface BonusOffer {
     id: string;
     tenantId?: string;
@@ -872,15 +1031,15 @@ export interface BonusOffer {
     description: string | null;
     bonusType: BonusType;
     matchPercent: number | null;
-    /** Integer cents. */
+    /** EUR, whole cents. */
     maxBonusAmount: number;
     wageringMultiplier: number;
     minOdds: number | null;
-    /** Integer cents. */
+    /** EUR, whole cents. */
     maxBetFromBonus: number | null;
     excludedMarkets: string[] | null;
     durationDays: number;
-    /** Integer cents. */
+    /** EUR, whole cents. */
     minQualifyingDeposit: number | null;
     maxActivations: number | null;
     maxPerUser: number | null;
@@ -898,7 +1057,7 @@ export interface BonusStats {
     activeCount: number;
     /** Percent of bonuses completed over the last 30 days. */
     completionRate30d: number;
-    /** Bonus balance outstanding, integer cents. */
+    /** Bonus balance outstanding (EUR, whole cents). */
     totalOutstanding: number;
     avgProgress: number;
 }
@@ -910,10 +1069,11 @@ export interface MissionDef {
     description: string | null;
     icon: string | null;
     criteriaType: string;
+    /** EUR, whole cents for total_wagered and total_wagered_window; otherwise a count. */
     criteriaThreshold: number;
     criteriaMeta: Record<string, unknown> | null;
     rewardType: string | null;
-    /** In cents for money types (bonus credit, free bet, fixed discount...), otherwise percent, days or points. Unlike reward rules and grants, which take EUR. */
+    /** EUR, whole cents for money types (bonus credit, free bet, fixed discount...), otherwise percent, days or points. */
     rewardValue: number;
     rewardApplyMode: string;
     startsAt: string;
@@ -950,7 +1110,7 @@ export interface TournamentPrize {
     rankFrom: number;
     rankTo: number;
     rewardType: string;
-    /** In cents for money types, otherwise percent, days or points. */
+    /** EUR, whole cents for money types, otherwise percent, days or points. */
     rewardValue: number;
 }
 /** Tournament definition (admin) */
@@ -994,7 +1154,7 @@ export interface TournamentEntry {
     qualifyingBets: number | null;
     rank: number | null;
     prizeType: string | null;
-    /** In cents for money types. */
+    /** EUR, whole cents for money types. */
     prizeValue: number | null;
     prizeGranted: boolean | null;
     enteredAt: string | null;
@@ -1083,13 +1243,13 @@ export interface RewardRule {
     tenantId?: string;
     name: string;
     description: string | null;
-    /** What triggers the grant: `type` reaching `threshold` (e.g. `{ type: 'active_days', threshold: 30 }`). */
+    /** What triggers the grant: `type` reaching `threshold` (e.g. `{ type: 'active_days', threshold: 30 }`). A total_wagered or total_profit threshold is EUR, whole cents. */
     criteria: {
         type: string;
         threshold: number;
     };
     rewardType: GrantableRewardType;
-    /** In EUR for money types, otherwise percent or days. Unlike missions and tournament prizes, which take cents. */
+    /** EUR, whole cents for money types, otherwise percent or days. */
     rewardValue: number;
     applyMode: RewardApplyMode;
     maxGrantsPerUser: number;
@@ -1133,7 +1293,7 @@ export interface ThemeUpdateRequest {
     customCopy?: Record<string, unknown>;
 }
 /** Events an operator can switch notifications on or off for. */
-export type NotificationPreferenceEvent = 'bet.validation_result' | 'challenge.activated' | 'challenge.completed' | 'challenge.failed' | 'cooldown.triggered' | 'cooldown.lifted' | 'funded_account.activated' | 'funded_account.payout' | 'funded_account.payout_requested' | 'funded_account.payout_rejected' | 'funded_account.revoked' | 'user.self_excluded' | 'user.self_exclusion_lifted';
+export type NotificationPreferenceEvent = 'bet.validation_result' | 'challenge.activated' | 'challenge.completed' | 'challenge.failed' | 'cooldown.triggered' | 'cooldown.lifted' | 'funded_account.activated' | 'funded_account.payout' | 'funded_account.payout_requested' | 'funded_account.payout_rejected' | 'funded_account.revoked' | 'funded_account.inactivity_warning' | 'funded_account.closing' | 'funded_account.closed' | 'funded_account.payout_debt' | 'user.self_excluded' | 'user.self_exclusion_lifted';
 /** Body for updating notification preferences: the events to change, true to notify. */
 export type NotificationPreferencesUpdate = Partial<Record<NotificationPreferenceEvent, boolean>>;
 /** Body for excluding a user. Without expiresAt or durationDays the exclusion is permanent. */