3-Tier Affiliate Plugin

A comprehensive multi-level referral marketing system for BeikeShop, featuring global & product-level commission rates, hold periods, payout approval workflows, and full API support.

Feature Overview

• 3-Tier Affiliate Architecture: Supports commission allocation across Level 1, Level 2, and Level 3 affiliates.
• Flexible Commission Rates: Configurable global rate + product-level overrides (Product-level takes priority, falls back to Global if empty; option to force global rate).
• Hold Period (Anti-Fraud): Configurable waiting period (N days) after order settlement before commissions become withdrawable.
• Payout Approval Workflow: Affiliate applies for withdrawal → Admin reviews and approves → Payout is dispatched.
• Automatic Affiliate Upgrade: Customers automatically become affiliates upon meeting a cumulative spend threshold ($N).
• Referral Tracking: Auto-generated referral links with automatic binding upon visit/registration (supports Session persistence).
• Mobile & App Ready: Includes native ShopAPI endpoints for seamless App/Mini-program integration.

Admin Configuration

1. Enable the Plugin

Go to Admin Panel → Plugins → Find "3-Tier Affiliate" → Install & Enable.

2. Configure Affiliate Parameters

Go to Admin Panel → Affiliate Management → Settings.

3. Configure Affiliate Products

Go to Admin Panel → Products → Edit Product → Right Sidebar "Affiliate Settings":

• Enable "Is Affiliate Product".
• Set Product-Level Commission Rates (optional; leave empty to use global default rates).

4. Manage Payout Approvals

Go to Admin Panel → Affiliate Management → Payout Requests:

• View withdrawal request list.
• Approve or Reject payout requests.

5. Monitor Commissions & Affiliates

Go to Admin Panel → Affiliate Management → Commissions / Affiliates to view detailed performance logs.

Storefront Operations

For Affiliates

1. Upgrade to Affiliate: Customer Dashboard Sidebar → "Become an Affiliate" (must meet minimum spend threshold).

2. Affiliate Center: Customer Dashboard Sidebar → "Affiliate Center".

   • Dashboard: Overview of total earnings, withdrawable balance, team size, and referred products.
   • Key Sections: My Commissions, Referral Links, Affiliate Products, My Team, Referred Customers, Commission Orders, Leaderboard, and Payout Requests.

For Regular Customers

1. Access the store via an affiliate’s referral link (?ref=AFFILIATE_ID).
2. Register an account (automatically binds referral relationship to the affiliate).
3. Place an order and complete payment. The referrer earns commission (withdrawable after the hold period).

Commission Workflow

Plaintext

User Places Order → Pending Record Created → Order Paid → Commission Settled + Balance Ledger Scheduled (available_at = now() + N days) → Hold Period Expires → Funds Available → Affiliate Requests Payout → Admin Approves → Payout Dispatched