Stripe Payment Intent切换自动捕获后出现400错误求助

核心原因 #

当你把capture_method设置为automatic后，Stripe会在支付完成（包括通过3D安全验证）自动触发PaymentIntent的捕获操作，而你的代码里仍保留了原manual模式下的手动捕获逻辑（比如调用PaymentIntent.capture()），导致重复执行捕获操作，触发payment_intent_unexpected_state错误。

3D安全验证的场景下，automatic捕获会在用户完成验证后立即执行，此时你的代码如果再调用捕获接口，就会收到“已被捕获”的报错。

解决步骤 #

• 移除手动捕获代码：删掉所有主动调用PaymentIntent.capture()的逻辑，包括同步接口调用或异步回调里的相关代码。
• 清理Webhook/回调逻辑：检查监听payment_intent.succeeded或payment_intent.processing等事件的代码，确保没有在这些事件触发后再次执行捕获操作。
• 校验PaymentIntent创建参数：创建PaymentIntent时，确认capture_method明确设为automatic，同时不要设置amount_capturable（该参数仅适用于manual模式）。示例创建代码：

  # 以Python为例，确保参数正确
  stripe.PaymentIntent.create(
    amount=1000,
    currency='usd',
    payment_method_types=['card'],
    capture_method='automatic'  # 明确设置为automatic
  )
  

• 验证流程：测试3D卡支付时，在Stripe后台查看PaymentIntent状态——完成验证后状态会直接变为succeeded，不会停留在requires_capture状态，无需额外操作。

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