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

