You need to enable JavaScript to run this app. Stripe订阅如何在60天试用结束前隐藏99.99美元年付方案
优惠活动
大模型
产品
解决方案
定价
更多

Stripe订阅如何在60天试用结束前隐藏99.99美元年付方案

试用期前隐藏年付方案的可落地实现

整个方案分前端展示控制、逻辑兜底校验两层落地,完全可以解决试用期内误显年付入口、点击切换触发流程异常的问题。

核心前置说明

你当前使用的ext-firestore-stripe-subscriptions官方扩展,本身会自动将用户的订阅状态(包括试用周期时间戳)同步到Firestore中,对应存储路径为/customers/{当前用户ID}/subscriptions,节点内的trial_end字段直接存储了当前用户试用到期的UNIX时间戳,不需要额外开发接口拉取试用状态。

具体实现步骤

  • 1. 页面层控制方案入口的展示逻辑
    进入订阅管理页面时,实时监听用户订阅节点的快照变化,拿到trial_end字段值后和当前系统时间对比:如果当前时间小于试用到期时间戳,说明用户还在60天试用期内,直接在渲染逻辑里隐藏99.99美元的年付方案卡片,同时禁用对应切换按钮的点击事件。
    前端判断逻辑参考:

    // 从Firestore快照获取的trialEnd值,单位为秒
    const isInTrialPeriod = trialEnd && Date.now() < trialEnd * 1000;
    
    // 仅当不在试用期时渲染年付方案入口
    {!isInTrialPeriod && (
      <div className="yearly-plan-option">
        <button onClick={() => createCheckoutSession('price_1Iav0JKDPaWWeL1yBa9F7Aht')}>
          切换为年付方案(99.99美元/年)
        </button>
      </div>
    )}
    
  • 2. 函数层做兜底拦截,绕过前端也触发不了异常流程
    纯前端的展示控制很容易被通过修改页面DOM触发,因此必须在createCheckoutSession函数里加前置校验:在写入Checkout会话、跳转Stripe之前,先拉取一次当前用户的试用状态,如果还在试用期,直接中断创建流程,不执行后续跳转。
    修改后的核心代码参考:

    export async function createCheckoutSession(priceId) {
      const user = firebase.auth().currentUser;
      if (!user) throw new Error("请先登录");
    
      // 前置拉取用户现有订阅状态
      const subSnap = await firestore
        .collection("customers")
        .doc(user.uid)
        .collection("subscriptions")
        .where("status", "in", ["trialing", "active"])
        .limit(1)
        .get();
      
      const currentSub = subSnap.docs[0]?.data();
      const trialEndTime = currentSub?.trial_end;
    
      // 试用期内拦截年付方案的会话创建
      if (trialEndTime && Date.now() < trialEndTime * 1000) {
        alert("60天试用结束后即可切换年付方案");
        return;
      }
    
      // 原有创建Checkout会话的逻辑
      const checkoutSessionRef = await firestore
        .collection("customers")
        .doc(user.uid)
        .collection("checkout_sessions")
        .add({
          price: priceId,
          success_url: "http://localhost:3000/successPage",
          cancel_url: "http://localhost:3000/signup",
        });
      
      // 原有监听会话ID、跳转Stripe的逻辑保持不变
      (await checkoutSessionRef).onSnapshot(snap => {
        const { error, sessionId } = snap.data();
        if (error) console.log(`An error occured: ${error.message}`);
        if (sessionId) {
          const stripe = window.Stripe('pk_test');
          stripe.redirectToCheckout({ sessionId })
        }
      })
    }
    
  • 3. 订阅切换的异常问题补全
    你提到当前试用期内切换年付会出现原有试用权益不取消、逻辑异常的问题,本质是因为用户在试用期内触发了订阅切换,Stripe默认会将新的年付订阅和原有的试用周期订阅并行存在,才会出现后续扣费逻辑冲突。只要加上上面两层拦截逻辑,试用期内根本触发不了年付的Checkout流程,这个异常自然不会出现。
    等用户试用到期后再点击切换年付时,Stripe会自动将原有月付订阅替换为新的年付订阅,不会出现并行扣费的问题。

补充说明:不需要修改原有的goToBilliingPortal函数逻辑,这个函数的作用只是跳转Stripe官方的账单管理门户,本身不会展示你自定义的年付方案卡片,自定义的方案展示完全由你的前端页面逻辑控制。

内容的提问来源于stack exchange,提问作者Gianluca

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.26 12:24:03