Laravel Cashier对接Stripe时测试卡4242总返回incomplete要求额外操作怎么办

1. Stripe平台配置校验 #

• 确认Stripe账户已切换到测试模式，使用的Publishable key、Secret key均为测试环境生成，未混用生产环境密钥
• 重点排查：测试模式下的「支付设置」是否强制开启了全量交易的3D Secure验证，默认测试模式仅对指定测试卡触发验证，若手动开启强制规则，4242卡也会被要求执行额外操作，关闭该强制规则即可恢复正常
• 查看Stripe Dashboard对应支付Intent的日志详情，确认status与next_action字段的具体值，定位要求执行的操作类型

2. Laravel Cashier配置校验 #

• 核对.env文件中STRIPE_SECRET、STRIPE_KEY与Stripe测试环境密钥完全一致，无多余空格或特殊字符
• 检查config/cashier.php配置文件，确认未开启强制3D Secure相关配置，payment_method_types数组包含card类型，无额外支付限制规则
• 执行php artisan config:clear清除配置缓存，确保修改后的配置生效

3. 订阅创建逻辑校验 #

• 确认创建订阅的代码中未手动添加payment_method_options[card][request_three_d_secure] = 'any'参数，该参数会强制所有交易走3D验证，正确配置应为automatic或不传入该参数
• 确认传入的支付方式ID有效，未复用已失效的测试支付凭证，可尝试重新生成4242测试卡的支付方式ID后再次发起订阅
• 检查Stripe webhook配置是否正常：Cashier依赖webhook回调同步订阅状态，若webhook未配置、签名校验失败或服务端无法接收Stripe回调，支付成功后订阅仍会保留incomplete状态
• 确认订阅关联的Stripe产品、价格配置正常，未设置需要二次确认的特殊规则

4. 基础测试操作校验 #

• 输入测试卡信息时，有效期选择未来任意时间，CVC填写任意3位数字，不要填写不符合格式的校验信息
• 若使用Stripe Elements前端组件发起支付，确认前端代码未手动添加额外的支付验证触发逻辑
• 可通过原生Stripe SDK直接发起测试支付验证问题根因，示例代码：

  \Stripe\Stripe::setApiKey(config('cashier.secret'));
  $intent = \Stripe\PaymentIntent::create([
      'amount' => 100,
      'currency' => 'usd',
      'payment_method' => 'pm_card_visa',
      'confirm' => true
  ]);
  

  若该调用返回成功状态则说明问题出在Cashier的封装逻辑或订阅配置上，反之则为Stripe账户配置问题。

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