双 12 进阶玩法:LikeShop 单商户标准版预售定金膨胀与尾款自动抵扣二开实现

简介: 双12预售定金膨胀方案:定金走原生支付锁定用户,尾款独立账单管理;金额在定金支付时固化,状态新增“待付尾款”,超时处置通过幂等定时任务兜底,全程不侵入原生`paySuccess()`核心链路。

双 12 的核心诉求是“锁客”与“逼单”,预售的定金膨胀玩法恰好能同时满足这两点:用小额定金锁定购买意向,再用“膨胀金额”制造不可抗拒的优惠感。但 LikeShop 单商户标准版的原生支付是一次性结清模型,没有为“钱分两次付”留出任何中间态。

这篇二开方案的核心原则是:不修改原生 OrderLogic::paySuccess() 的核心链路,定金走原生支付通道,尾款走独立的“预售账单”体系,通过定时任务驱动尾款提醒与超时处置。

🏗️ 核心架构:定金与尾款解耦

原生支付链路假设“钱一次付完”,支付成功后立即进入待发货、扣库存、发积分。预售需要在这个模型上切一刀:用户支付定金时,订单状态不能进入“待发货”,而是进入一个新增的中间态“待付尾款”;只有尾款结清后,才触发原生的发货与结算链路。

架构上拆成两条线:

定金链路(复用原生) :用户提交预售订单 → 创建一条 order_type = presale 的订单 → 调用原生支付接口支付定金 → 支付回调验签通过后,不走 OrderLogic::paySuccess() 的完整逻辑,而是将订单状态置为“待付尾款”,并生成一条预售账单记录。

尾款链路(独立账单) :尾款金额在定金支付后即固化(受定金膨胀、阶梯折扣、优惠券、积分影响)→ 到达尾款支付窗口期时,用户通过独立入口支付尾款 → 尾款回调将账单状态置为已结清 → 此时才调用原生的 OrderLogic::paySuccess() 完成订单的正式履约状态流转。

🗄️ 数据模型:预售活动与账单表

🛒 预售活动配置表

新建 ls_presale_activity,存储定金膨胀规则和尾款时间窗口:

CREATE TABLE `ls_presale_activity` (
  `id` int UNSIGNED NOT NULL AUTO_INCREMENT,
  `name` varchar(100) NOT NULL COMMENT '活动名称',
  `goods_id` int NOT NULL,
  `sku_id` int DEFAULT NULL,
  `original_price` decimal(10,2) NOT NULL COMMENT '商品原价/会员价',
  `deposit_amount` decimal(10,2) NOT NULL COMMENT '定金金额',
  `expansion_amount` decimal(10,2) NOT NULL COMMENT '定金膨胀优惠金额(必须 >= 定金)',
  `deposit_start_time` int UNSIGNED NOT NULL COMMENT '定金支付开始时间',
  `deposit_end_time` int UNSIGNED NOT NULL COMMENT '定金支付截止时间',
  `balance_start_time` int UNSIGNED NOT NULL COMMENT '尾款支付开始时间',
  `balance_end_time` int UNSIGNED NOT NULL COMMENT '尾款支付截止时间',
  `ladder_enable` tinyint DEFAULT 0 COMMENT '是否开启阶梯折扣',
  `ladder_rules` varchar(500) DEFAULT '' COMMENT '阶梯规则JSON:如[{qty:50,discount:0.8}]',
  `status` tinyint DEFAULT 0 COMMENT '0-草稿 1-进行中 2-已结束',
  PRIMARY KEY (`id`),
  KEY `idx_goods_time` (`goods_id`, `deposit_start_time`, `deposit_end_time`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

定金膨胀的核心约束:expansion_amount 必须大于等于 deposit_amount。如果设置定金 100、膨胀优惠 200,则尾款计算时自动减免 200 元。

🧾 预售账单表

新建 ls_presale_bill,承载每笔预售订单的尾款债务:

CREATE TABLE `ls_presale_bill` (
  `id` bigint UNSIGNED NOT NULL AUTO_INCREMENT,
  `order_id` int NOT NULL,
  `activity_id` int NOT NULL,
  `user_id` int NOT NULL,
  `deposit_paid` decimal(10,2) NOT NULL COMMENT '已付定金',
  `deposit_pay_time` int UNSIGNED DEFAULT 0,
  `balance_amount` decimal(10,2) NOT NULL COMMENT '应付尾款金额(定金支付后固化)',
  `balance_status` tinyint DEFAULT 0 COMMENT '0-待支付 1-已支付 2-已超时取消',
  `balance_pay_time` int UNSIGNED DEFAULT 0,
  `balance_due_time` int UNSIGNED NOT NULL COMMENT '尾款支付截止时间',
  `stock_locked` tinyint DEFAULT 1 COMMENT '库存是否已锁定',
  `create_time` int UNSIGNED DEFAULT 0,
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_order` (`order_id`),
  KEY `idx_balance_due` (`balance_status`, `balance_due_time`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

stock_locked 字段用于超时取消时判断是否需要回收库存。如果订单在尾款逾期前已经发货(部分商家可能在定金后就发货),则 stock_locked = 0,超时取消时跳过库存回收,只关闭账单。

💰 尾款金额计算:定金支付时固化

尾款金额不能等到用户来支付时才计算,必须在定金支付成功的那一刻就算好并写入 ls_presale_bill.balance_amount。原因是:用户在定金支付后可能使用优惠券、积分,或者会员等级发生变化;如果在支付尾款时才计算,会出现“同一订单不同时间看到不同尾款”的体验问题,也容易引发纠纷。

📐 计算公式

尾款金额 = (售价/会员价 × 阶梯折扣 - 定金膨胀优惠金额 - 优惠券分摊 - 积分抵扣) × 会员卡折扣

其中,优惠券的使用门槛按 售价 × 阶梯折扣 判断,而非按原价。定金膨胀优惠金额在尾款中直接减免,不涉及定金的退还——定金本身已经支付,膨胀部分是额外让利。

💻 PHP 实现

在定金支付回调中,完成账单创建和尾款固化:

class PresaleLogic
{
   
    /**
     * 定金支付成功后,创建预售账单并固化尾款金额
     */
    public static function afterDepositPaid(int $orderId): void
    {
   
        $order = OrderModel::find($orderId);
        $activity = PresaleActivityModel::find($order['presale_activity_id']);

        // 1. 计算阶梯折扣后的基础金额
        $baseAmount = $activity['original_price'];
        if ($activity['ladder_enable']) {
   
            $qty = OrderGoodsModel::where('order_id', $orderId)->sum('goods_num');
            $rules = json_decode($activity['ladder_rules'], true);
            $discount = 1.0;
            foreach ($rules as $rule) {
   
                if ($qty >= $rule['qty']) {
   
                    $discount = $rule['discount'];
                }
            }
            $baseAmount = $baseAmount * $discount;
        }

        // 2. 扣除定金膨胀优惠(直接减免)
        $afterExpansion = max(0, $baseAmount - $activity['expansion_amount']);

        // 3. 扣除优惠券分摊(门槛按 baseAmount 判断)
        $couponDeduct = CouponLogic::calcDeduction($order['coupon_id'], $baseAmount);
        $afterCoupon = max(0, $afterExpansion - $couponDeduct);

        // 4. 扣除积分抵扣
        $integralDeduct = IntegralLogic::calcDeduction($order['integral_used'], $afterCoupon);
        $afterIntegral = max(0, $afterCoupon - $integralDeduct);

        // 5. 会员卡折扣
        $memberDiscount = UserLevelLogic::getDiscount($order['user_id']);
        $finalBalance = round($afterIntegral * $memberDiscount, 2);

        // 6. 写入预售账单
        PresaleBillModel::create([
            'order_id'         => $orderId,
            'activity_id'      => $activity['id'],
            'user_id'          => $order['user_id'],
            'deposit_paid'     => $order['deposit_amount'],
            'deposit_pay_time' => time(),
            'balance_amount'   => $finalBalance,
            'balance_status'   => 0,
            'balance_due_time' => $activity['balance_end_time'],
            'stock_locked'     => 1,
            'create_time'      => time(),
        ]);
    }
}

关键边界:如果 finalBalance 计算结果为 0(膨胀金额 + 优惠券 + 积分完全覆盖了尾款),则直接将账单标记为已结清,并调用 OrderLogic::paySuccess() 完成订单,无需用户再次支付 0 元订单。

🔄 状态机扩展:新增“待付尾款”态

LikeShop 原生订单状态为 0-待付款、1-待发货、2-待收货、3-已完成、4-已关闭。预售订单需要在 0 和 1 之间插入一个状态 5-待付尾款(具体编码可根据现有空闲值调整)。

状态流转规则:

0(待付款/定金未付) → 5(待付尾款/定金已付) → 1(待发货/尾款已付) → 2(待收货) → 3(已完成)

所有状态变更必须走统一的 OrderStatusLogic::transit() 入口,禁止在任何地方直接 update order_status。在 canTransit() 中增加预售专用路径:

// 在现有 TRANSITIONS 数组中扩展
const TRANSITIONS = [
    // ... 原有路径
    0 => [1, 4, 5],  // 待付款 → 待发货 / 已关闭 / 待付尾款(预售定金支付成功)
    5 => [1, 4],     // 待付尾款 → 待发货(尾款支付成功)/ 已关闭(尾款超时)
];

定金支付回调中,验签通过后执行 OrderStatusLogic::transit($orderId, 5, '定金支付成功,等待尾款'),同时触发 PresaleLogic::afterDepositPaid()。尾款支付回调中,先校验账单状态,再执行 transit($orderId, 1, '尾款支付成功,进入待发货'),此时才真正调用原生的发货、积分、分销等后续逻辑。

⏰ 定时任务:尾款提醒与超时处置

LikeShop 的定时任务通过一条 php think crontab 命令统一调度,每分钟执行一次,子任务在后台「系统设置 → 系统维护 → 定时任务」中配置和开关。预售需要新增两个子任务。

📢 尾款到期提醒(每日执行)

扫描 balance_status = 0 且 balance_due_time 在 24~48 小时内到期的账单,通过模板消息或短信提醒用户:

public function remindBalance(): void
{
   
    $now = time();
    $bills = PresaleBillModel::where('balance_status', 0)
        ->where('balance_due_time', '>', $now)
        ->where('balance_due_time', '<', $now + 86400 * 2)
        ->where('remind_sent', 0) // 新增字段防重复提醒
        ->limit(200)
        ->select();

    foreach ($bills as $bill) {
   
        MessageService::sendBalanceRemind($bill['user_id'], $bill['order_id'], $bill['balance_amount']);
        PresaleBillModel::where('id', $bill['id'])->update(['remind_sent' => 1]);
    }
}

🚫 尾款超时关闭(每分钟执行)

扫描 balance_status = 0 且 balance_due_time < now 的账单,执行超时处置。这个操作必须严格幂等,用条件更新抢占:

public function closeOverduePresale(): void
{
   
    $now = time();
    $bills = PresaleBillModel::where('balance_status', 0)
        ->where('balance_due_time', '<', $now)
        ->limit(50)
        ->select();

    foreach ($bills as $bill) {
   
        Db::startTrans();
        try {
   
            // 幂等抢占:只有仍在待支付状态的账单才能被处理
            $affected = PresaleBillModel::where('id', $bill['id'])
                ->where('balance_status', 0)
                ->update([
                    'balance_status' => 2,
                    'update_time'    => $now,
                ]);
            if (!$affected) {
   
                Db::rollback();
                continue; // 已被其他进程处理
            }

            // 1. 回收库存(仅在未发货时)
            $order = OrderModel::find($bill['order_id']);
            if ($bill['stock_locked'] == 1 && $order['order_status'] == 5) {
   
                GoodsLogic::releaseStock($bill['order_id']);
            }

            // 2. 关闭订单(走状态机)
            OrderStatusLogic::transit($bill['order_id'], 4, '尾款超时未支付,预售订单关闭');

            // 3. 定金处理:按活动配置退还比例(默认不退,或按规则扣除违约金)
            $refundRate = PresaleActivityModel::where('id', $bill['activity_id'])->value('deposit_refund_rate') ?? 0;
            $refundAmount = round($bill['deposit_paid'] * $refundRate / 100, 2);
            if ($refundAmount > 0) {
   
                RefundService::refundDeposit($bill['order_id'], $refundAmount, '预售尾款超时,按规则退还定金');
            }

            Db::commit();
        } catch (\Exception $e) {
   
            Db::rollback();
            Log::error("预售尾款超时取消失败 bill_id={$bill['id']}: " . $e->getMessage());
        }
    }
}

定金退还的边界:预售的定金通常具有“担保”性质,用户违约时可以不退或部分退还。deposit_refund_rate 设为 0 表示不退定金,设为 100 表示全退。这个策略必须在活动配置中明确,并在用户支付定金前通过协议或页面提示告知,避免客诉。

⚠️ 二开避坑清单

坑一:在定金支付回调中直接调用 paySuccess()。 定金支付不等于尾款结清,直接调用会触发发货、积分发放、分销结算,导致“只付了定金却收到了货”。定金回调只应执行 transit(5) 和账单创建。

坑二:尾款金额在支付时才实时计算。 优惠券、积分、会员折扣的状态可能在定金支付后发生变化。必须在定金支付成功时固化 balance_amount,尾款支付时只做校验和扣款,不做重新计算。

坑三:超时关闭没有做幂等。 定时任务可能因重试或并发执行多次处理同一账单。必须用 where balance_status = 0 的条件更新抢占,影响行数为 0 则直接跳过。

坑四:已发货的订单仍然回收库存。 如果商家在定金后就发货,尾款逾期时库存已经不在仓库,回收会导致负库存。超时处置前必须校验 stock_locked 和订单发货状态。

坑五:定金膨胀金额与优惠券门槛计算顺序错误。 优惠券门槛应按 售价 × 阶梯折扣 判断,而不是按扣除膨胀金额后的金额判断。顺序错误会导致本应可用的优惠券被判定为不可用。

坑六:状态机被绕过。 预售新增的“待付尾款”状态必须纳入 OrderStatusLogic 的统一管理。如果在回调中直接 update order_status = 5,后续的状态校验和日志记录都会失效。

💎 总结

LikeShop 单商户标准版预售定金膨胀的二开,核心是三条线:

架构分离:定金走原生支付通道但不触发完整履约,尾款走独立账单体系。不修改 OrderLogic::paySuccess() 的核心链路,只在正确的时机调用它。

金额固化:尾款金额在定金支付成功时一次性算清并写入账单,后续支付不再重新计算。膨胀金额、阶梯折扣、优惠券、积分、会员卡折扣的计算顺序必须严格遵循 (售价×折扣 - 膨胀 - 券 - 积分)× 会员卡折扣。

异步兜底:尾款提醒和超时处置通过 LikeShop 已有的 crontab 机制驱动,超时关闭必须幂等,库存回收必须校验发货状态。

守住三条底线:定金回调不触发履约、尾款金额支付时不算账、超时处置必做幂等。这样既能让定金膨胀的营销玩法跑起来,又不会让预售订单破坏 LikeShop 原有的支付与库存一致性。

目录
相关文章
|
3天前
|
弹性计算 人工智能 API
Codex超详细入门指南(下载·安装·登录·上手,全版本覆盖,2026最新版)
建议收藏本教程,2026 全年各版本更新随时回来查阅。如果你在搭建过程中遇到任何问题,欢迎结合 阿里云工单系统 提交技术支持请求,或在 阿里云开发者社区 搜索 Codex 相关话题交流。 祝你编码愉快,效率翻倍!
1595 1
|
6天前
|
JSON 前端开发 API
阿里云最新Qwen4-Max大模型介绍:模型定位、特征、能力、适用场景解析
2026 年 11 月 11 日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问 AI 平台 Token Plan,并同步接入千问办公、Qoder 等入口。该版本聚焦知识理解、世界感知、编程与 Agentic 四项升级,主打复杂编程、专业办公、前端设计与专业软件操作。预览期至 11 月 25 日 24:00,到期后模型标识下线;限时 2 折、新用户再享 5 折,最低 1 折可体验。
|
6天前
|
人工智能 前端开发 API
阿里云Qwen4-Max 大模型详解:定位、特征、能力、适用场景与相对Qwen3-Max差异解析
2026年11月11日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问AI平台Token Plan并接入千问办公、Qoder等入口。该版本聚焦知识理解、世界感知、编程与Agentic四项升级,主打复杂编程、专业办公、前端设计与专业软件操作等真实任务。预览期为11月11日10:00至11月25日24:00,仅支持Token Plan调用,到期后模型标识下线;限时2折、新用户再享5折,最低1折可体验。
|
3天前
|
Linux Go 开发工具
手机上跑 DeepSeek 智能体:开源安卓客户端 DSH Go 安装与使用指南
DSH Go 是一款开源安卓客户端,将 DeepSeek Harness 智能体引擎装进手机:免 Root、免 Termux,一键安装即用;支持本机运行(内置 Ubuntu+Node.js)或远程接管电脑会话;具备插话打断、过程折叠、屏幕操控、端到端加密分享等特色功能,真正实现智能体“口袋化”。
2648 0
|
18天前
|
Linux 开发工具 iOS开发
Codex保姆级教程(下载+安装+登录+使用,含所有版本,2026最新)
Codex是OpenAI推出的开源AI编程智能体,本地运行,可理解整个代码库,支持自然语言指令改代码、执行命令、跑测试、修Bug,兼容Win/macOS/Linux。(239字)
8293 58
|
13天前
|
Linux 开发工具 iOS开发
2026最新codex下载安装保姆级使用教程(下载+安装+登录+使用,含所有历史版本)
本文详解OpenAI Codex国内快速上手指南:提供Win/macOS/Linux全平台免安装包、npm/Homebrew等多方式安装、账号/API Key双登录、简体中文切换,覆盖下载、安装、汉化、使用及高频避坑(如微软商店失败、npm超时等),10分钟即可跑通。
2986 9
|
19天前
|
JavaScript API iOS开发
DeepSeek Harness下载、安装、配置一篇搞定(2026整理,送常用插件)
DeepSeek Harness(DSH)是DeepSeek于2026年开源的MIT协议AI Agent框架,支持插件化组装模型、工具、沙箱与UI,兼容主流大模型。本文提供免Node.js的桌面端安装包(Win/macOS),含详细图文教程及热门插件推荐。
5757 69
|
7天前
|
云安全 人工智能 安全
|
11天前
|
人工智能 安全 API
DeepSeek Harness下载、安装、配置一篇搞定(2026整理,送常用插件)
DeepSeek Harness(dsh)是DeepSeek AI于2026年开源的轻量级Agent运行框架,基于Cordis内核,践行“一切皆插件”理念。支持Web/桌面双端,开箱即用;内置多模型接入、丰富插件生态(超3.5万),适配编程、办公、创作等场景。(239字)
1899 1