二级分销小程序开发：ThinkPHP 源码完整的搭建教程，商城分佣系统

私域商城二级分销是现在很常用的裂变模式，很多个体商家、供货商想要搭建自己的分销商城，靠老客推广拉新。市面上很多分销源码逻辑复杂，而 ThinkPHP 框架上手简单、文档成熟，适合快速搭建合规的二级分销商城。本文围绕商城二级分佣场景，从整体架构、模块设计、数据表、分佣逻辑、源码搭建部署等维度梳理，给开发者和商家提供一套可落地的方案。

一、二级分销商城小程序整体架构设计

整套系统分为用户小程序、分销推广端、平台管理后台，全部基于 ThinkPHP 后端驱动，各端职责划分清晰。

/* 架构流向简图 */
用户小程序 --> ThinkPHP后端
    ↓
推广分销端 <--> MySQL + Redis
    ↓
平台管理后台


二、商城商品与分销订单基础模块设计

商城支持实物商品下单，用户通过分享链接或海报进入，自动绑定上下级关系；下单后只计算一级推广人、二级推广人佣金，严格控制二级，不允许多级。佣金支持按商品单独设置比例，也支持后台全局统一比例。

CREATE TABLE `dist_order` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键ID',
  `order_no` varchar(64) NOT NULL COMMENT '订单单号',

  `user_id` bigint NOT NULL COMMENT '下单用户ID',
  `goods_id` bigint NOT NULL COMMENT '商品ID',
  `first_pid` bigint DEFAULT 0 COMMENT '一级推广人',
  `second_pid` bigint DEFAULT 0 COMMENT '二级推广人',
  `pay_amount` decimal(10,2) NOT NULL COMMENT '实付金额',
  `commission_one` decimal(10,2) NOT NULL DEFAULT '0.00' COMMENT '一级佣金',
  `commission_two` decimal(10,2) NOT NULL DEFAULT '0.00' COMMENT '二级佣金',
  `order_status` tinyint NOT NULL DEFAULT '0' COMMENT '0待支付 1已支付 2已发货 3已完成 4已退款',
  `pay_status` tinyint NOT NULL DEFAULT '0' COMMENT '0未支付 1已支付',
  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`),

  UNIQUE KEY `idx_order_no` (`order_no`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='分销订单表';


/**
 * 下单绑定分销关系、生成订单【第一段业务代码】
 */
public function createOrder($param)
{

    Db::startTrans();
    try {
        $userId = $param['user_id'];
        $spreadPid = $param['spread_pid'] ?? 0;
        $userInfo = User::find($userId);
        // 首次访问绑定上级

        if ($spreadPid > 0 && empty($userInfo['pid'])) {
            $pUser = User::find($spreadPid);

            if ($pUser) {
                $userInfo->pid = $spreadPid;
                $userInfo->save();
            }
        }
        // 获取一级、二级推广人
        $firstId = $userInfo['pid'];
        $secondId = $firstId ? User::where('id',$firstId)->value('pid') : 0;
        $goods = Goods::find($param['goods_id']);
        // 计算两级佣金
        $commissionOne = bcmul($param['pay_amount'], $goods['rate_one'], 2);
        $commissionTwo = bcmul($param['pay_amount'], $goods['rate_two'], 2);

        $orderNo = date('YmdHis') . mt_rand(1000,9999);

        DistOrder::create([
            'order_no' => $orderNo,
            'user_id' => $userId,
            'goods_id' => $param['goods_id'],
            'first_pid' => $firstId,
            'second_pid' => $secondId,
            'pay_amount' => $param['pay_amount'],
            'commission_one' => $commissionOne,
            'commission_two' => $commissionTwo,
            'order_status' => 0,
            'pay_status' => 0
        ]);
        Db::commit();

        return ['code' => 0, 'msg' => '下单成功', 'data' => ['order_no'=>$orderNo]];
    } catch (\Exception $e) {

        Db::rollback();
        return ['code' => -1, 'msg' => '订单创建失败'];
    }
}


用户提交订单并支付成功，佣金进入冻结状态；订单确认收货完成后，佣金解冻，可申请提现；订单退款，则对应的两级佣金直接作废，不发放。

用户扫码/链接下单 --> 待支付
    ↓
支付成功 --> 已支付，佣金冻结
    ↓
商家发货、用户确认收货 --> 订单完成，佣金解冻
    ↓
推广人提交提现申请，平台审核打款

订单退款审核通过 --> 佣金作废，不发放


业务规则：只允许二级分佣，超出二级的用户不产生佣金；支持设置自动确认收货时间，超时自动解冻佣金。

系统支持两种分佣模式：全局比例、商品独立比例。 推广溯源逻辑：用户点击推广链接，后端缓存推广人 ID，缓存有效期后台可配置，一般 30 天，有效期内再次下单都绑定该推广人。 Redis 用来缓存推广溯源记录，减少数据库查询压力。 佣金不直接入账，必须等订单完成解冻，降低退款带来的资金风险。

/**
 * 订单完成，佣金解冻逻辑【第二段业务代码】
 */
public function unlockCommission($orderId)
{
    $order = DistOrder::find($orderId);
    if (!$order || $order['order_status'] != 3) {
        return ['code' => -1, 'msg' => '订单未完成，无法解冻佣金'];
    }
    $logData = [];
    if ($order['first_pid'] > 0 && $order['commission_one'] > 0) {
        User::where('id',$order['first_pid'])->inc('commission',$order['commission_one'])->update();
        $logData[] = [

            'user_id'=>$order['first_pid'],
            'order_id'=>$orderId,
            'money'=>$order['commission_one'],
            'type'=>1,
            'remark'=>'一级推广佣金'
        ];
    }
    if ($order['second_pid'] > 0 && $order['commission_two'] > 0) {

        User::where('id',$order['second_pid'])->inc('commission',$order['commission_two'])->update();
        $logData[] = [
            'user_id'=>$order['second_pid'],
            'order_id'=>$orderId,
            'money'=>$order['commission_two'],
            'type'=>1,
            'remark'=>'二级推广佣金'
        ];
    }
    CommissionLog::insertAll($logData);

    return ['code' => 0, 'msg' => '佣金解冻成功'];
}


五、小程序能力与推广海报模块

商城采用预付下单模式，支付成功才会开始走分销流程。

用户选择商品结算
    ↓
后端生成订单，记录分销上下级
    ↓
小程序拉起微信支付
    ↓
微信异步回调通知后端
    ↓
校验回调签名，更新订单支付状态，冻结佣金


回调做好幂等处理，防止重复多次计算佣金；定时任务关闭超时未支付订单，不生成佣金。

后台可以统计商品销量、推广业绩、佣金流水、提现记录。

-- 推广员佣金汇总

SELECT user_id,SUM(money) as total_commission FROM commission_log WHERE type=1 GROUP BY user_id ORDER BY total_commission DESC;

-- 分销订单统计
SELECT DATE(create_time) as day,COUNT(id) as order_num,SUM(pay_amount) as pay_total

FROM dist_order WHERE pay_status=1 AND order_status NOT IN (4) GROUP BY day ORDER BY day DESC;


小程序端：UniApp 后端：ThinkPHP6 数据库：MySQL8.0，Redis 缓存推广溯源、缓存用户推广信息 消息通知：微信订阅消息，订单提醒、佣金到账、提现审核通知 部署环境：Linux、Nginx、PHP8.1

dist-server
├── app
│   ├── api        // 小程序接口
│   ├── admin      // 平台后台
│   ├── service    // 分销、分佣、订单业务层
│   └── model      // 用户、订单、佣金、商品模型
├── config         // 微信支付、redis、数据库配置
└── public


基于 ThinkPHP 搭建二级分销商城，框架轻量化，二次开发门槛低，核心重点就是严格控制二级分佣、推广溯源、佣金冻结解冻、退款回滚佣金。分销系统最容易踩坑的地方是多级关系错乱、重复发放佣金、退款不追回佣金。这套方案合规实现二级分销，适合特产、美妆、日用百货等实物私域商城，商家可以依靠老客裂变引流，后续按需叠加营销、自动提现等功能。

后端

数据库

前端

基于ThinkPHP的二级分销小程序源码完整教程，覆盖商城搭建、分佣系统及私域裂变。提供用户端、分销端、管理后台全架构，支持商品独立佣金比例、两级佣金冻结解冻、退款自动回滚。UniApp前端配合PHP8后端快速部署，适用于实物商城老客裂变拉新，源码开源可二次开发。

服务器

MySQL

Redis

Linux

Nginx

腾讯云双十一大促

热销域名限时优惠，新客首年免费！


domain

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

二级分销小程序开发：ThinkPHP 源码完整的搭建教程，商城分佣系统

二级分销小程序开发：ThinkPHP 源码完整的搭建教程，商城分佣系统

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐