Stripe Payment Link传client_reference_id失效重复创建客户问题

你拼接的client_reference_id参数被Stripe忽略的核心原因是：Payment Link不支持前端跳转时动态拼接业务关联参数，所有client_reference_id、prefilled_email这类用于客户关联、信息预填的参数，必须在服务端调用API创建Payment Link的阶段传入请求体，事后在URL尾部拼接的参数会被Stripe默认过滤，不会生效。
另外你对Checkout Session的场景适配存在认知偏差：Checkout Session创建后返回的url字段是公网可直接访问的支付链接，完全可以直接调用系统默认浏览器打开，不需要内嵌WebView组件，适配你当前的桌面端场景。

方案1：修正Payment Link的参数传参逻辑 #

• 废弃提前生成通用Payment Link、前端拼接参数的实现方式，改为用户发起支付时，由服务端针对当前用户单独生成专属Payment Link：

const paymentLink = await stripe.paymentLinks.create({
  line_items: [
    {
      price: price.id,
      quantity: 3,
    },
  ],
  // 创建时直接传入关联参数，不要前端拼接
  client_reference_id: customerId, // 你自有系统的用户唯一ID
  prefilled_email: stripeCustomer.email, // 预填用户邮箱
  customer: stripeCustomer.id, // 可选，传入已有的Stripe客户ID，避免Stripe重复创建客户条目
});

• 桌面端拿到服务端返回的完整Payment Link后，直接调用系统接口拉起默认浏览器打开即可，不需要内嵌WebView。
• 支付结果不要依赖前端跳转回传的参数判断，在Stripe后台配置Webhook，监听checkout.session.completed事件，事件体中会携带你传入的client_reference_id，凭此ID匹配自有数据库的用户账户即可。

方案2：改用Checkout Session实现（灵活度更高） #

如果需要更灵活的支付配置（比如动态调整订单金额、加自定义字段、控制支付成功后的跳转逻辑），直接用Checkout Session即可：

• 服务端创建Checkout Session时直接传入所有关联参数：

const session = await stripe.checkout.sessions.create({
  line_items: [
    {
      price: price.id,
      quantity: 3,
    },
  ],
  mode: 'payment',
  client_reference_id: customerId,
  customer_email: stripeCustomer.email,
  customer: stripeCustomer.id,
  success_url: '你的支付成功跳转地址',
  cancel_url: '你的支付取消跳转地址',
});

• 创建成功后，接口会返回session.url字段，桌面端直接拿这个URL拉起系统浏览器打开即可，和Payment Link的使用逻辑完全一致，不需要WebView支持。
• 同样通过Webhook接收支付结果，用返回的client_reference_id做用户和订单的关联，不会出现客户匹配错误的问题。

所有涉及用户关联、订单关联的支付参数，必须在服务端调用Stripe API时传入，不要在前端拼接修改，既可以避免参数被Stripe过滤，也能防止参数被恶意篡改导致的资损、订单匹配错误问题。

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