django-referral-system 0.1.1

A Django app for managing referral programs, promoters, referrals, and tracking referral performance with advanced features like commission setting, invitation management, and Wise payouts.

django-referral-system

A Django app for managing referral programs, promoters, referrals, and tracking referral performance with features like commission setting, invitation management, and Wise payouts.

Documentation

Full documentation is available at Read the Docs.

Features

• Promoter Management: Easily create and manage promoters who can invite referrals to join your platform.
• Referral Tracking: Promoters can track their list of referrals, including invitation details, sign-up status, and more.
• Earnings Monitoring: Promoters can view their recent earnings, including commissions from successful referrals.
• Commission-Based Rewards: Promoters earn money by receiving commissions from referrals they invite, with configurable commission rates.
• Customizable Payout Methods: Promoters can set and update their preferred payout methods and minimum withdrawal balances.
• Referral Link Creation: Generate unique referral links that promoters can share to invite others to the platform.
• Referral Program Flexibility: Only one referral program can be active at a time, allowing for focused and streamlined referral management.
• Detailed Payout History: Promoters can view their full payout history, allowing for transparency and easy tracking of payment status.
• Click Tracking: Keep track of how many times a referral link has been clicked.

Installation

1. Install the package via pip:

pip install django-referral-system

2. Add referrals to your INSTALLED_APPS in settings.py:

INSTALLED_APPS = [
    # other apps
    'referrals',
]

3. Add to urls.py

from django.urls import path, include

urlpatterns = [
    # Other URL patterns...
    path('referrals/', include("referrals.urls")),
]

4. Apply Migrations

python manage.py migrate

5. Create a Referral Program
   After installation, you can create a new referral program using the provided management command: If this program is set to active, any previous active referral programs will be deactivated automatically.

python manage.py create_referral_program --name="My Referral Program" --commission-rate=5.00 --min-withdrawal-balance=10.00

License

This package is licensed under the MIT License. See the LICENSE file for more details.

Contributing

If you find any issues or have suggestions, feel free to open an issue or submit a pull request.