Binary Plan Setup Documentation

Complete guide to configure and implement Binary MLM compensation plan

Last updated: February 1, 2024 Version: 2.1.0 Difficulty: Intermediate

Binary Plan Overview

The Binary MLM compensation plan organizes distributors in a two-legged structure where each member can sponsor only two direct downlines. Commission is calculated based on the weaker leg's performance, encouraging balanced growth across both legs.

Key Characteristics:
  • • Two-legged structure (Left & Right legs)
  • • Commission based on weaker leg volume
  • • Encourages balanced team building
  • • Fast growth potential with spillover
  • • Suitable for motivated networkers

How Binary Plan Works

In a Binary plan, each distributor has two positions to fill - left and right. When both positions are filled, the distributor becomes active and starts earning commissions based on the business volume generated in their weaker leg.

Binary Plan Example

Distributor A
├── Left Leg (Volume: 5000 PV)
│   ├── Distributor B
│   └── Distributor C
└── Right Leg (Volume: 3000 PV)
    ├── Distributor D
    └── Distributor E

Commission Calculation: Based on weaker leg = 3000 PV
                

Prerequisites

Before configuring the Binary plan, ensure you have the following prerequisites in place:

1. System Requirements

  • MLMPortal.in software version 2.0 or higher
  • MySQL 5.7+ or PostgreSQL 10+ database
  • PHP 7.4+ with required extensions
  • Minimum 2GB RAM for production environment
  • SSL certificate for secure transactions

2. Business Configuration

  • Company profile and settings configured
  • Product catalog with point values (PV)
  • Payment gateway integration
  • User roles and permissions defined
  • Tax settings configured
Important: Ensure you have a complete backup of your database before making any configuration changes to the compensation plan settings.

Binary Plan Configuration

Follow these steps to configure the Binary plan in your MLMPortal.in admin panel.

Step 1: Access Plan Settings

  1. Login to your MLMPortal.in admin panel
  2. Navigate to Settings → Compensation Plans
  3. Click on Add New Plan
  4. Select Binary Plan from the plan types

Step 2: Basic Plan Configuration

Configure the basic settings for your Binary plan:

// Binary Plan Basic Configuration { "plan_name": "Standard Binary Plan", "plan_type": "binary", "status": "active", "description": "Standard Binary compensation plan with balanced leg requirements", "start_date": "2024-02-01", "currency": "INR" }
Parameter Description Required Default
plan_name Unique name for your Binary plan Yes -
plan_type Must be "binary" Yes -
status Plan status (active/inactive) Yes active
currency Commission currency Yes INR

Step 3: Plan Structure Settings

Configure the Binary plan structure and rules:

// Binary Structure Configuration { "binary_settings": { "carry_forward": "enabled", "carry_forward_period": "weekly", "flush_carry_forward": "monthly", "matching_bonus_depth": 10, "capping_period": "daily" } }

Commission Settings

Configure commission rates and calculation methods for your Binary plan.

Binary Commission Configuration

// Commission Settings { "commission_settings": { "pair_commission_type": "percentage", "pair_commission_rate": 10, "pair_calculation_type": "weaker_leg", "minimum_pairs": 1, "maximum_pairs": "unlimited", "pair_rate": 0.10, "pair_value": 100, "trench_amount": 500 } }
Parameter Description Example Value
pair_commission_type Percentage or fixed amount percentage
pair_commission_rate Commission percentage per pair 10
pair_calculation_type Weaker leg or stronger leg weaker_leg
minimum_pairs Minimum pairs for commission 1
trench_amount Maximum commission per day 500

Bonus Settings

Configure additional bonus structures for your Binary plan:

// Bonus Configuration { "bonus_settings": { "fast_start_bonus": { "enabled": true, "rate": 20, "duration_days": 30 }, "matching_bonus": { "enabled": true, "rate": 10, "depth": 5 }, "leadership_bonus": { "enabled": true, "levels": [5, 10, 15], "requirements": { "personal_volume": 1000, "team_volume": 10000 } } } }

Binary Rules & Validation

Configure rules and validation criteria for your Binary plan structure.

Placement Rules

// Placement Rules { "placement_rules": { "auto_placement": "enabled", "placement_type": "power_leg", "allow_manual_placement": true, "force_placement": false, "placement_depth_limit": 20 } }
Placement Types:
  • power_leg - New members placed in stronger leg
  • weaker_leg - New members placed in weaker leg
  • manual - Manual placement by upline
  • auto_balance - Automatic balancing placement

Validation Rules

// Validation Rules { "validation_rules": { "minimum_joining_product": "starter_pack", "active_status_requirement": { "personal_volume": 100, "time_period": "monthly" }, "carry_forward_rules": { "enabled": true, "period": "weekly", "maximum_carry_forward": 1000 } } }

Payout Settings

Configure payout methods, schedules, and thresholds for your Binary plan.

Payout Configuration

// Payout Settings { "payout_settings": { "payout_frequency": "weekly", "payout_day": "monday", "minimum_payout": 500, "maximum_payout": 50000, "payout_methods": ["bank_transfer", "upi", "wallet"], "auto_payout": true, "payout_approval": "auto" } }
Parameter Description Options
payout_frequency How often payouts are processed daily, weekly, monthly
minimum_payout Minimum amount for payout Any numeric value
payout_methods Available payout methods bank_transfer, upi, wallet, cheque
payout_approval Payout approval process auto, manual

Testing & Validation

Test your Binary plan configuration before going live.

Test Commission Calculation

// Test Commission Calculation POST /api/v1/commission/test { "plan_id": "binary_001", "left_leg_volume": 5000, "right_leg_volume": 3000, "commission_type": "pair" } // Response { "status": "success", "commission_amount": 300, "calculation_details": { "weaker_leg": "right", "weaker_leg_volume": 3000, "commission_rate": 10, "pairs_calculated": 30 } }

Validation Checklist

  • Test commission calculations with various leg volumes
  • Verify placement rules work correctly
  • Test carry-forward functionality
  • Validate bonus calculations
  • Test payout processing
  • Verify genealogy tree generation

Troubleshooting

Common issues and solutions for Binary plan configuration.

Common Issues

  • • Commission not calculating for balanced legs
  • • Placement not working automatically
  • • Carry-forward not functioning
  • • Genealogy tree display issues

Debug Commission Calculation

// Enable debug mode UPDATE system_settings SET value = 'true' WHERE setting_key = 'debug_mode'; // Check commission logs SELECT * FROM commission_logs WHERE user_id = ? AND plan_id = ? ORDER BY created_at DESC LIMIT 10;

Common Solutions

  • Verify plan status is set to "active"
  • Check minimum PV requirements are met
  • Validate placement rules configuration
  • Ensure carry-forward settings are correct
  • Check user active status and qualifications

API Integration

API endpoints for Binary plan integration and automation.

Core API Endpoints

// Create Binary Plan POST /api/v1/plans/binary Content-Type: application/json Authorization: Bearer {api_key} { "plan_name": "Standard Binary", "commission_rate": 10, "settings": { ... } } // Calculate Commission POST /api/v1/commission/calculate { "user_id": "user_123", "plan_id": "binary_001", "period": "2024-02" } // Get Binary Tree GET /api/v1/genealogy/binary/{user_id}

Webhook Events

Binary plan specific webhook events for real-time notifications:

// Webhook Payload Example { "event": "commission.calculated", "data": { "user_id": "user_123", "plan_id": "binary_001", "commission_amount": 1500, "period": "2024-02", "calculation_details": { ... } }, "timestamp": "2024-02-01T10:30:00Z" }

Need Help with Binary Plan Setup?

Our technical support team is available to help you configure and optimize your Binary compensation plan.

Contact Support