ReactTS+ASP.NET项目集成Stripe Checkout报错求助

问题本质 #

这个错误的核心是：Stripe Checkout创建支付会话时，line_items里的price字段必须传入Stripe后台生成的Price对象ID（格式一般是price_xxxxxx），不能直接传产品的金额数值——哪怕你把数值转成字符串也不满足要求。

解决步骤 #

1. 为商品关联Stripe Price ID #

首先得在Stripe后台给每个商品创建对应的Price对象：

• 登录Stripe Dashboard，进入「产品」页面
• 点击「创建产品」，填写商品名称、描述，设置匹配你业务的价格、货币、计费方式
• 创建完成后，复制生成的Price ID（比如price_123ABC），把这个ID存到你自己数据库的产品表中，和对应商品绑定

2. 后端ASP.NET代码调整 #

把之前直接传价格数值的逻辑，改成从数据库读取对应商品的Stripe Price ID，再传入Stripe会话创建接口：

// 产品实体类新增StripePriceId字段，用于存储Stripe生成的价格ID
public class Product
{
    public int Id { get; set; }
    public string Name { get; set; }
    public decimal Price { get; set; }
    public string StripePriceId { get; set; } 
}

// 创建Stripe支付会话的API接口
[HttpPost("create-checkout-session")]
public async Task<IActionResult> CreateCheckoutSession([FromBody] List<CartItem> cartItems)
{
    var sessionOptions = new SessionCreateOptions
    {
        PaymentMethodTypes = new List<string> { "card" },
        LineItems = new List<SessionLineItemOptions>(),
        Mode = "payment",
        SuccessUrl = "https://your-domain.com/success",
        CancelUrl = "https://your-domain.com/cancel",
    };

    foreach (var cartItem in cartItems)
    {
        var product = await _dbContext.Products.FindAsync(cartItem.ProductId);
        if (product == null || string.IsNullOrEmpty(product.StripePriceId))
        {
            return BadRequest($"产品ID {cartItem.ProductId} 未配置有效的Stripe Price ID");
        }

        sessionOptions.LineItems.Add(new SessionLineItemOptions
        {
            Price = product.StripePriceId, // 这里传入Stripe Price ID，而非金额数值
            Quantity = cartItem.Quantity,
        });
    }

    var sessionService = new SessionService();
    var session = await sessionService.CreateAsync(sessionOptions);

    return Ok(new { sessionId = session.Id });
}

3. 前端React TypeScript代码调整 #

前端从Context获取购物车数据后，只需传递产品ID和数量到后端，不需要处理价格数值——价格相关逻辑由后端通过Stripe Price ID完成：

// 购物车Context中的结算方法
const handleInitiateCheckout = async () => {
  try {
    // 构造仅包含产品ID和数量的请求数据
    const checkoutItems = cart.map(item => ({
      productId: item.product.id,
      quantity: item.quantity
    }));

    const response = await fetch('/api/create-checkout-session', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify(checkoutItems),
    });

    const { sessionId } = await response.json();
    const stripe = await loadStripe('你的Stripe公钥');
    await stripe?.redirectToCheckout({ sessionId });
  } catch (err) {
    console.error('结算失败:', err);
  }
};

补充说明 #

如果你的业务需要动态定价（比如用户自定义金额），可以使用Stripe的「自定义金额」Price对象，或者在创建会话时通过price_data字段动态生成Price（需符合Stripe的规则）；另外要确保Stripe后台的Price对象处于「活跃」状态，否则会导致会话创建失败。

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