问题1：为何Stripe会在发票（invoice）创建完成前对账户进行扣费？ #

首先得明确Stripe发票的状态流转逻辑：发票会经历 draft（草稿）→ open（待支付）→ paid（已支付）的状态变化。你觉得“扣费在发票创建完成前”，大概率是混淆了发票创建的时机和付款触发的时机，常见原因有这几种：

• 订阅默认即时付款逻辑：当你创建订阅时，Stripe默认的payment_behavior参数是default，这个设置会让系统在生成草稿发票（触发invoice.created webhook）后，立即将发票转为open状态并发起付款请求。这个过程几乎是同步的，所以会出现invoice.created webhook还没处理完，付款已经在执行的情况，看起来像是“扣费早于发票创建完成”。
• 首次订阅的即时扣费规则：对于新订阅的首次付款，Stripe会跳过草稿状态的等待（部分场景下），直接生成待支付发票并发起扣费，这是为了确保订阅能立即生效。
• 一次性发票的直接支付：如果是手动创建一次性发票并调用支付接口，Stripe会在发票生成的同时触发付款，不会等待invoice.created webhook的处理。

简单来说，Stripe的扣费动作通常是在发票进入open状态时触发，而invoice.created webhook是在发票处于draft状态时发送的，两者的时间差非常短，导致你产生了“扣费在前”的错觉。

问题2：订阅时想根据系统内用户余额调整收费费率，但Stripe立即扣费，未等待invoice.created webhook修改，且webhook返回500 #

这个问题的核心是Stripe默认的自动付款流程跳过了你的修改逻辑，再加上webhook处理逻辑出错，导致双重问题：

为什么修改没生效？ #

默认情况下，订阅创建后Stripe会自动将草稿发票转为open并发起付款，这个速度比webhook的处理速度快得多，等你的invoice.created webhook开始修改发票时，它可能已经进入open状态了——而open状态的发票是无法修改金额或 line items 的，所以你的调整根本没机会生效。

怎么解决这个问题？ #

你需要手动干预发票的付款流程，步骤如下：

1. 创建订阅时设置payment_behavior: 'default_incomplete'：这个参数会让Stripe生成草稿发票后，保持draft状态，不会自动发起付款。这样你就有足够的时间在invoice.created webhook里修改发票内容。
2. 在invoice.created webhook中修改发票：根据系统内用户的余额，你可以通过以下方式调整收费：
   • 使用invoice.update()接口修改line items的金额；
   • 给发票添加折扣（比如创建一个临时优惠券，折扣金额等于用户可抵扣的余额）；
   • 调整订阅的价格（如果是长期调整的话）。
3. 修改完成后手动触发付款：调用invoice.pay()接口，将草稿发票转为open状态并发起付款请求。

关于webhook返回500的排查方向 #

webhook返回500说明你的处理逻辑有错误，建议从这几点排查：

• 检查Stripe Dashboard的webhook日志，里面会有详细的错误堆栈信息，比如API调用失败的原因（认证错误、参数格式错误、权限不足等）；
• 确认你在修改发票时，是否使用了正确的API版本，并且调用invoice.update()时的参数格式符合要求（比如line items的结构是否正确）；
• 检查你的服务是否在处理webhook时出现了超时或异常，比如数据库连接失败、余额查询逻辑出错等。

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