如何为Stripe结账控制器提供产品ID？

首先明确：文档里的product: '{{PRODUCT_ID}}'是示例占位符，不是可运行代码，你需要替换为Stripe后台创建的真实产品ID（格式为prod_xxxxxx），同时要注意Stripe API的参数要求，以下是正确的实现方式：

核心要点 #

Stripe Checkout创建Session时，line_items中的product参数必须配合价格信息（price或price_data）使用，不能单独传递产品ID，这是很多人踩坑的点。

正确写法示例 #

1. 后端硬编码产品ID（测试场景） #

直接传入字符串格式的产品ID，同时指定价格数据：

const session = await stripe.checkout.sessions.create({
  payment_method_types: ['card'],
  line_items: [
    {
      product: 'prod_abc123', // 替换成你的产品ID
      quantity: 1,
      price_data: {
        currency: 'usd',
        unit_amount: 2000, // 单位为分，代表20美元
      },
    },
  ],
  mode: 'payment',
  success_url: 'https://yourdomain.com/success',
  cancel_url: 'https://yourdomain.com/cancel',
});

2. 从变量动态获取产品ID #

如果你的product是包含id属性的对象（比如从数据库查询得到），直接传递product.id即可，确保它是字符串类型：

// 假设product是从数据库获取的对象，结构为 { id: 'prod_abc123', ... }
const session = await stripe.checkout.sessions.create({
  payment_method_types: ['card'],
  line_items: [
    {
      product: product.id, // 直接使用对象的id属性
      quantity: 1,
      price_data: {
        currency: 'usd',
        unit_amount: 2000,
      },
    },
  ],
  mode: 'payment',
  success_url: 'https://yourdomain.com/success',
  cancel_url: 'https://yourdomain.com/cancel',
});

常见错误排查 #

• 不要在后端代码中使用模板语法（{{product.id}}或#{product.id}），除非你用的是模板引擎（如EJS），此时要确保模板引擎能正确解析变量并输出字符串ID。
• 单独传递product参数会报错，必须搭配price_data（自定义价格）或price（使用产品已关联的价格ID）。
• 确认你的Stripe API版本与文档一致，不同版本的参数格式可能有差异，可以通过Stripe Dashboard查看当前API版本。

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