# دعوت دوستان و پاداش‌ها

کد دعوت، شرایط ثبت پاداش و تفاوت محاسبهٔ پاداش با پرداخت پول.

وضعیت: نیازمند پیکربندی | مخاطب: کاربران دارای حساب
بازبینی مستندات: ۲۰۲۶/۰۹/۲۴ · ۲ مهر ۱۴۰۵

## ساخت و اشتراک کد

بخش /account/referrals کدهای دعوت، لینک اشتراک و گزارش مربوط را نمایش می‌دهد. حساب واجد شرایط می‌تواند تا ۲۰ کد با عنوان دلخواه داشته باشد؛ کد از منبع تصادفی سرور ساخته و یکتایی آن در پایگاه داده کنترل می‌شود.

دکمه‌های کپی، ایمیل و واتس‌اپ لینک و متن را آماده می‌کنند. ارسال نهایی با کاربر است و هیچ پیام دعوتی خودکار فرستاده نمی‌شود.

## ارتباط دعوت چگونه ثبت می‌شود؟

لینک دعوت دارای ref و auth=register است. اولین کد دارای قالب معتبر تا ۳۰ روز در مرورگر نگهداری می‌شود و کاربر می‌تواند پیش از ثبت‌نام آن را تغییر دهد یا حذف کند.

سرور اعتبار کد و تأیید اطلاعات تماس دعوت‌کننده را بررسی می‌کند. نسبت دعوت هنگام ساخت حساب تازه ثبت می‌شود؛ ورود یا ویرایش پروفایل بعدی آن را تغییر نمی‌دهد. دادهٔ نگهداری‌شدهٔ مرورگر پس از ورود پاک می‌شود.

## شرایط پاداش

تنظیمات پاداش ثابت، سهم از کارمزد و فعال‌بودن طرح توسط مدیر مجاز تعیین می‌شوند. مقادیر بذر، ۵۰٬۰۰۰ تومان و ۲۰ درصد از کارمزد دریافت‌شدهٔ معامله‌اند؛ نمایش نرخ جاری باید از تنظیمات واقعی خوانده شود.

پاداش ثابت به تأیید تماس، احراز هویت و نخستین معاملهٔ واقعیِ تسویه‌شدهٔ دعوت‌شونده وابسته است. سهم معامله از کارمزد نهایی محاسبه می‌شود، نه از اصل سرمایه یا مبلغ فرضی فرم. پروژهٔ نمونه پاداش واقعی ندارد.

## محاسبه و پرداخت دو وضعیت مستقل‌اند

پاداش accrued یعنی محاسبه‌شده؛ paid نیازمند ثبت و اثبات پرداخت واقعی است. محاسبهٔ پاداش به‌تنهایی موجودی کیف پول را افزایش نمی‌دهد.

مرورگر مجوز نوشتن سفارش، کارمزد یا پاداش ندارد. اتصال تسویهٔ واقعی معامله و پرداخت خودکار هنوز فعال نیست؛ گزارش‌های آماده نباید وعدهٔ درآمد قابل برداشت از نمونه‌ها تلقی شوند.

## مراجع پیاده‌سازی

- components/referral-dashboard.tsx
- lib/referrals.ts
- app/api/referrals/route.ts
- supabase/migrations/202609080007_referral_program.sql
- REFERRALS.md