17370845950

在 stripe 中，不能通过 `cancel()` 方法设置 `cancel_at_period_end` 参数来延迟取消订阅；必须使用 `update()` 方法更新订阅对象，将 `cancel_at_period_end` 设为 `true` 才能实现“到期自动终止”。

Stripe 的订阅取消机制分为两种行为：立即取消（immediate cancellation）和周期结束时取消（cancellation at period end）。关键在于：cancel() 接口仅支持立即终止，并忽略所有如 cancel_at_period_end 或 invoice_now 等非标准参数（这些参数在该端点

要实现“订阅保留至当前计费周期结束、之后不再续订”的效果，正确做法是调用 subscriptions->update() 方法，仅传入 'cancel_at_period_end' => true：

try {
    $subscription = $stripe->subscriptions->update(
        $subscription_id,
        [
            'cancel_at_period_end' => true
        ]
    );

    // 可选：检查响应确认状态
    if ($subscription->cancel_at_period_end) {
        echo "订阅已成功设置为周期结束时取消。";
    }
} catch (\Stripe\Exception\ApiErrorException $e) {
    error_log("Stripe 更新订阅失败: " . $e->getMessage());
    throw $e;
}

✅ 注意事项：

• cancel_at_period_end 是布尔值，设为 true 后，Stripe 会自动将 cancel_at 字段更新为当前周期的 current_period_end 时间戳；
• 订阅在到期前仍保持 active 状态，用户可继续享受服务，且不会触发额外账单；
• 若后续需提前立即取消，可再次调用 cancel()（此时将无视 cancel_at_period_end，强制终止）；
• 不要混用 invoice_now 和 cancel_at_period_end —— 前者仅适用于立即取消并开票的场景，与延期取消逻辑冲突。

? 小贴士：可通过 $subscription->status 和 $subscription->cancel_at_period_end 字段实时校验订阅状态，确保业务逻辑与 Stripe 实际行为一致。