邀请返佣
RavenSaaS 实现了一套邀请返佣系统。你可以在你的产品中使用这套系统来激励用户邀请新用户。
如何使用
使用步骤
1
用户生成邀请链接
用户进入 /users/my-invites 页面，可以生成自己的邀请链接。
2
分享邀请链接
用户分享出去的邀请链接类似：http://localhost:3000/i/LdO51N
3
新用户注册
新用户通过分享者的邀请链接进入系统，会自动关联到分享者。
4
查看邀请记录
分享者可以在 /users/my-invites 页面查看邀请记录和邀请奖励。
5
管理员后台管理
管理员可以在后台查看邀请记录和邀请奖励。
注意：暂不支持在线自动提现，需要管理员人工联系用户发放奖励。
数据表结构
邀请返佣表
data/install.sql
1CREATE TABLE affiliates (
2 id SERIAL PRIMARY KEY,
3 user_uuid VARCHAR(255) NOT NULL,
4 paid_order_no VARCHAR(255),
5 status VARCHAR(50) NOT NULL,
6 paid_amount INT,
7 reward_percent INT,
8 reward_amount INT,
9 invited_by VARCHAR(50),
10 created_at timestamptz
11);自定义奖励规则
默认奖励规则
当前默认规则：
- • 新用户通过邀请链接注册：只记录状态，不发放奖励
- • 用户每次支付：给邀请人发放 20% 金额奖励
新用户注册时，会请求 /src/app/api/payment/orders/create 接口。你可以修改此接口的逻辑，更改新用户注册场景下的奖励规则。
/src/app/api/payment/orders/create/route.ts
1await insertAffiliate({
2 user_uuid: session.user.uuid,
3 invited_by: user.invited_by,
4 status: AffiliateStatus.Pending,
5 paid_order_no: orderNo || "",
6 paid_amount: 0,
7 reward_percent: AffiliateRewardPercent.Paied,
8 reward_amount: 0,
9 created_at: new Date().toISOString(),
10});