如何防止Stripe接收付款时创建重复用户？（Laravel+Vue场景）

原因分析 #

每次创建Stripe Checkout会话时，若未指定已存在的Stripe客户ID，Stripe会自动生成新客户（或访客记录）——即使邮箱相同，也会因客户ID不同产生重复条目。另外，若你的Laravel用户已通过Cashier关联Stripe客户，但生成会话时未复用该关联，也会导致重复创建。

解决方案 #

1. 复用Laravel Cashier关联的客户
   如果你用Cashier管理用户订阅，每个User模型已通过billable trait绑定Stripe客户。生成会话时直接复用该客户ID即可：

   // StripeController 生成会话代码
   $user = auth()->user(); // 确保用户已登录
   $session = $user->checkoutSession([
       'line_items' => [
           [
               'price' => 'price_xxx', // 你的测试价格ID
               'quantity' => 1,
           ],
       ],
       'mode' => 'subscription', // 支付模式：subscription或payment
       'success_url' => route('checkout.success'),
       'cancel_url' => route('checkout.cancel'),
   ]);
   // 此方式会自动关联用户已有的Stripe客户，不会重复创建
   

2. 访客场景：手动查询复用同邮箱客户
   针对未登录用户，可先查询Stripe是否存在对应邮箱的客户，再决定新建或复用：

   $email = request()->input('email');
   $stripe = new \Stripe\StripeClient(config('cashier.secret'));
   // 搜索Stripe中该邮箱的客户
   $customers = $stripe->customers->search([
       'query' => "email:'{$email}'",
       'limit' => 1,
   ]);
   $customerId = null;
   if (!empty($customers->data)) {
       $customerId = $customers->data[0]->id;
   } else {
       // 无匹配则新建客户
       $customer = $stripe->customers->create(['email' => $email]);
       $customerId = $customer->id;
   }
   // 生成会话时指定customer参数
   $session = $stripe->checkout->sessions->create([
       'customer' => $customerId,
       'line_items' => [...], // 你的商品/订阅项
       'mode' => 'subscription',
       'success_url' => route('checkout.success'),
       'cancel_url' => route('checkout.cancel'),
   ]);
   

原因分析 #

要么是后端生成会话时未设置customer_email参数，要么是vue-stripe组件未正确传递邮箱，或是会话已关联现有客户（此时会直接使用客户绑定的邮箱，不显示输入框）。

解决方案 #

1. 后端会话添加customer_email参数
   若为访客模式或需要强制预填邮箱，创建会话时明确传入邮箱：

   $session = $stripe->checkout->sessions->create([
       // 其他必填参数...
       'customer_email' => request()->input('email'), // 接收前端传入的邮箱
   ]);
   

   注意：如果会话已关联现有Stripe客户（设置了customer参数），Checkout会自动使用客户的邮箱，不会显示输入框，这是正常逻辑。

2. 前端vue-stripe组件正确传参
   确保前端将邮箱传递给后端生成会话，示例代码：

   <template>
     <button @click="initCheckout">开始结账</button>
     <stripe-checkout
       ref="checkoutRef"
       :pk="publishableKey"
       :session-id="sessionId"
       @success="handleSuccess"
       @error="handleError"
     />
   </template>
   <script setup>
   import { ref, onMounted } from 'vue';
   import { StripeCheckout } from '@vue-stripe/vue-stripe';
   
   const publishableKey = import.meta.env.VITE_STRIPE_PUBLISHABLE_KEY;
   const sessionId = ref('');
   const checkoutRef = ref(null);
   // 从用户输入或登录信息中获取邮箱
   const userEmail = ref('test@example.com');
   
   const initCheckout = async () => {
     // 向后端请求会话ID，同时传递邮箱
     const res = await fetch('/api/stripe/create-session', {
       method: 'POST',
       headers: {
         'Content-Type': 'application/json',
         'X-CSRF-TOKEN': document.querySelector('meta[name="csrf-token"]').content
       },
       body: JSON.stringify({ email: userEmail.value })
     });
     const data = await res.json();
     sessionId.value = data.session_id;
     // 触发结账跳转
     checkoutRef.value.redirectToCheckout();
   };
   </script>
   

额外提示 #

• 测试模式下，Stripe会根据客户ID区分记录，而非邮箱——所以复用客户ID是解决重复问题的核心。
• 若用户已登录且通过Cashier绑定Stripe客户，Checkout会直接使用客户的邮箱信息，无需手动预填。

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