如何在Stripe客户门户中区分同一产品的多子女订阅？

方法1：创建订阅时设置订阅昵称（推荐） #

当你通过API为学生创建订阅时，在subscriptions.create的请求参数中添加nickname字段，把孩子的名字嵌入进去：

// 示例代码（Node.js）
const stripe = require('stripe')('你的API密钥');

const subscription = await stripe.subscriptions.create({
  customer: '家长的Stripe客户ID',
  items: [{ price: '初学者版月度订阅的Price ID' }],
  nickname: `月度订阅（${studentName}专属）`, // 替换为实际学生姓名
  metadata: { student_id: '对应Supabase的学生ID' } // 保留关联用的元数据
});

设置后，家长在客户门户中看到的订阅项会直接显示这个昵称，替代默认的产品名称，轻松区分不同孩子的订阅。

方法2：自定义订阅描述并在门户显示 #

如果不想修改昵称，也可以设置订阅的description字段，然后配置客户门户显示描述内容：

1. 创建订阅时添加描述：

const subscription = await stripe.subscriptions.create({
  customer: '家长的Stripe客户ID',
  items: [{ price: '初学者版月度订阅的Price ID' }],
  description: `为学生${studentName}订阅的月度初学者版`,
  metadata: { student_id: '对应Supabase的学生ID' }
});

2. 进入Stripe控制台，依次打开「设置」→「客户门户」→「订阅选项」，找到「显示订阅描述」并勾选保存。之后客户门户里的订阅项会附带显示这段描述，帮助家长区分。

方法3：利用订阅元数据并通过门户自定义显示（进阶） #

如果需要更灵活的展示，还可以在订阅的metadata中存储学生信息，然后通过Stripe客户门户的自定义页面来渲染元数据（需前端开发配合）：

• 创建订阅时存入元数据：metadata: { student_name: 'Hannah', student_id: 'xxx' }
• 在Stripe控制台配置客户门户时，选择自定义页面，通过模板变量调用元数据（比如{{subscription.metadata.student_name}}）来展示学生名称。

注意：Stripe产品名称是全局配置，无法为单个订阅修改产品本身的名称，所有区分逻辑都需要通过订阅级别的字段（昵称、描述、元数据）来定制显示内容。

内容的提问来源于stack exchange，提问作者Andreul-