编辑 Stripe 发票行项目描述

Question

我的雇主刚刚让一位客户对 Stripe 发送的发票电子邮件感到困惑，该电子邮件是按比例分配的定期订阅费用：

Unused time on Silver plan after 27 Aug 2015      -$48.13
Remaining time on Gold plan after 27 Aug 2015     $240.63
Subscription to Gold plan                         $250.00

她以为她被收取了额外一个月的费用。我们真的很想让这些费用的含义更加明显，例如通过指定每个项目适用的确切时间段 - 就像 Stripe 在其仪表板中显示的那样：

Unused time on Silver plan    Aug 27, 2015 — Sep 26, 2015    -$48.13
Remaining time on Gold plan   Aug 27, 2015 — Sep 26, 2015    $240.63
Subscription to Gold plan     Sep 26, 2015 — Oct 26, 2015    $250.00

但是，除了标题之外，我看不到自定义 Stripe 发票电子邮件的方法，虽然我们可以在 webhook 回调中编辑按比例分配发票项目的描述，但我看不到编辑描述的方法订阅项目。根据API documentation，line item的id要么是invoice item ID要么是subscription ID，所以line item本身不能直接检索或编辑，我也不想编辑description订阅本身，只是这张发票上的项目。

这样做的唯一方法是从头开始发送我们自己的发票而不使用 Stripe 的发票，还是有什么我没有发现的方法？

Answer 1

不支持直接更新这些自动创建的订单项的文本。相反，如果您想在更新订阅时对此施加更多控制，您可以使用proration_behavior=none（API ref、doc）禁用按比例分配，并可选择使用add_invoice_items（API ref）添加您自己的订单项)。

请注意，add_invoice_items 仅支持 正 金额，因此对于降级，您需要允许按比例分配或考虑使用 Credit Notes 或 Customer balance 调整。