Skip to content

۲۴ — رفرال دوطرفه (دعوت دوست + معرفی کافه)

قوانین محصول

قانونمقدار
پاداش۵۰٪ تخفیف، سقف ۷۰٬۰۰۰ تومان، یک‌بارمصرف، scope=platform
آزادسازیفقط پس از picked_up
دعوت‌شدهفقط User جدید؛ attribution فقط در اولین OTP با ref
سقف ماهانه دعوت‌کننده۳۰ unlock موفق (تقویم تهران)
یارانهپلتفرم؛ وندور unitPrice × quantity می‌بیند
لینک{NEXT_PUBLIC_APP_URL}/?ref=CODE و /vendor/register?ref=CODE

مدل داده

  • User.inviteCode / User.referredByUserId
  • Vendor.referredByUserId
  • ReferralReward (friend_invite | cafe_invite)
  • DiscountCode.ownerUserId + source

نقاط هوک

  1. POST /api/auth/otp/verify + ref → فقط روی create
  2. POST /api/vendor/orders/confirm-pickup → unlock
  3. POST /api/vendor/register + ref → cafe pending reward
  4. GET /api/me/referral → داشبورد دعوت
  5. POST /api/orders/[id]/apply-discount → مالک کد

UI

  • /invite — هاب دعوت (لینک، QR، NFC در صورت پشتیبانی، معرفی کافه)
  • پروفایل — تیزر دعوت
  • بعد از picked_upShareAfterPickup
  • ?ref= روی خانه — بنر نرم + ذخیره cookie/session

Env

NEXT_PUBLIC_APP_URL باید برای stage برابر https://stage.takeeat.ir و برای prod برابر https://app.takeeat.ir باشد.