What this section is for

Use Affiliates / Refer a Friend to configure the player referral program. An authenticated player can share a personal link or QR code, track linked activity, and claim an accumulated referral reward when the service confirms that a reward is available.

The feature is optional. If the project does not run a player referral program, leave the percentage at zero and do not add the player-facing CMS section.

What must be configured

Setting	Operator impact
referAFriendPercent	Percentage applied to qualifying referral cashback activity. A zero or missing value also hides the player-facing component.
referAFriendLanding	Fallback landing path when no selectable landing option is configured.
referAFriendLandingOptions	Selectable landing entries with internal name, display name, and URL.
referAFriendBonusOptions	Optional deposit-bonus IDs or deposit-bonus groups offered in the link builder.

The player-facing CMS page must also contain General - Refer a Friend. CMS visibility, audience, device, and tag rules still apply. The component itself requires an authenticated player and a non-zero referral percentage.

Player flow

1. The signed-in player opens the Refer a Friend section.
2. The player selects an available landing and, when configured, a bonus option.
3. The site builds a referral link and matching QR code.
4. A visit can increment when the link recipient reaches the tracked flow.
5. A registration increments only when a new referral relationship is created.
6. Depositors counts distinct referred players with at least one successful deposit.
7. The displayed Revenue value is the player's current accumulated referral-reward balance, not general business revenue.
8. Claiming a positive balance creates the configured rakeback bonus, resets the stored referral balance, and redirects the player to Cashback.

The verified reward calculation uses the qualifying NGR value produced for the referred player during instant-cashback processing:

qualifying referred-player NGR input x referAFriendPercent / 100

The percentage is applied before conversion into the referrer's active wallet currency. This is not a percentage of the referred player's rakeback payout.

Do not promise that both people receive a reward. The traced implementation confirms the referrer's reward only. Bonus availability and final eligibility are evaluated by the live product flow and can vary.

Landing and bonus choices

• With no landing options, the link falls back to referAFriendLanding, then /.
• Bonus groups take priority over direct bonus IDs and expand to active deposit bonuses.
• A configured choice controls the link builder; it does not guarantee that every recipient will qualify for that bonus.
• The referral token transports landing and bonus values. It must not be described as a tamper-proof signature.

Custom player fields

A non-empty Custom Referral Link replaces the generated link and QR code and hides the landing and bonus selectors.

Stream Custom Text is used by the non-mobile Stream Tool. It is not the text shown in the Refer a Friend section.

Attribution safeguards

• self-referral is rejected
• an existing referral relationship prevents a second normal mapping
• affiliate PID attribution takes precedence over Refer a Friend registration credit in the verified flow
• a custom link can change how attribution reaches the product, so test it before a campaign starts

Related monitoring

Affiliates / Referrals is a separate monitoring list for referred players and their referrers. It does not configure the player referral program.

Player-level referral statistics and the Custom Referral Link or Stream Custom Text are maintained from the related player-detail workflow, not from the Referrals monitoring list.

The structured definitions for player-visible statistics and claim behavior are kept in the separate Refer a Friend / Player Delivery content unit rather than in the configuration form.

Troubleshooting

If the block is missing, confirm authentication, a positive referral percentage, a published General - Refer a Friend section, and the section's CMS visibility rules.

If registrations are missing, confirm that the recipient used the tracked link, was not already mapped, was not the referrer, and was not attributed through an affiliate PID.

If a reward cannot be claimed, confirm that qualifying activity produced a positive unclaimed balance and that the player's wallet and configured rakeback bonus flow are available.

Access recommendation

Limit configuration access to affiliate, marketing, VIP, or senior operations users. Changes affect customer acquisition links and reward accrual, so test the published section and one end-to-end referral before launching a campaign.