双 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 原有的支付与库存一致性。