openfrontio / openfrontio/OpenFrontIO

[Feature] Refer a player — referral mechanic for subscribers and purchasers

Open
#4,044 0 comments 0 reactions 1 assignee Claimed by @evanpelle View on GitHub
approved Backend Feature Monetization
Dominant language
TypeScript
Stars
2.7k
Forks
1.4k
Avg merge
17h 43m
Merged PRs (30d)
310

Description

## Overview
Existing subscribers or purchasers can refer new players via a unique referral link. Reward triggered on qualifying action.

## Scope
- Unique referral link per player
- New player signs up via referral link
- Reward triggered on qualifying action (first purchase or subscription start)
- Referrer rewarded (caps, discount code, or cosmetic — product decision)
- Attribution tracked correctly

## Acceptance criteria
- [ ] Referral link generated per player
- [ ] Attribution tracked from link click to qualifying action
- [ ] Reward automatically issued to referrer on qualifying action
- [ ] Referral history visible on profile

## Dependencies
- **Depends on:** OAuth, Stripe

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.