Stripe SubscriptionAddInvoiceItemOptions无Metadata属性，无法添加订单项元数据

这确实是Stripe API的当前限制：通过SubscriptionAddInvoiceItemOptions（对应API中订阅更新时的add_invoice_items参数）添加的一次性收费订单项，无法直接设置Metadata——该选项类本身没有暴露这个属性，且底层API endpoint也不支持通过该路径传递metadata参数。

可行替代方案 #

1. 单独创建带Metadata的InvoiceItem并关联到订阅

这是最直接的解决方法：绕过SubscriptionAddInvoiceItemOptions，直接使用InvoiceItemCreateOptions创建一次性收费项，同时设置Metadata，并指定关联的订阅ID。这样生成的订单项会自动被纳入订阅的下一张待支付发票，且metadata会直接绑定到该订单项上。

示例代码：

var invoiceItemService = new InvoiceItemService();
var createOptions = new InvoiceItemCreateOptions
{
    Subscription = "sub_your_subscription_id", // 目标订阅ID
    Amount = 5000, // 金额，单位为最小货币单位（如50美元=5000美分）
    Currency = "usd",
    Description = "一次性服务费",
    Metadata = new Dictionary<string, string>
    {
        { "order_id", "ORD-12345" },
        { "service_type", "premium_setup" }
    }
};

var invoiceItem = invoiceItemService.Create(createOptions);

2. 退而求其次：在Invoice层级存储带标识的Metadata

如果因业务限制必须使用SubscriptionAddInvoiceItemOptions，可以将metadata存储在Invoice的Metadata中，但需要通过特定前缀或标识关联到对应的一次性收费项。例如：

var subscriptionService = new SubscriptionService();
var updateOptions = new SubscriptionUpdateOptions
{
    AddInvoiceItems = new List<SubscriptionAddInvoiceItemOptions>
    {
        new SubscriptionAddInvoiceItemOptions { Amount = 5000, Currency = "usd" }
    },
    Metadata = new Dictionary<string, string>
    {
        { "one_time_charge_order_id", "ORD-12345" },
        { "one_time_charge_service_type", "premium_setup" }
    }
};

var subscription = subscriptionService.Update("sub_your_subscription_id", updateOptions);

后续获取发票时，可通过发票内的订单项信息（如金额、描述）匹配对应的metadata。

关于草稿发票的说明 #

你尝试的草稿订阅发票方案不可行是预期的：草稿发票需要手动触发支付流程，而订阅的自动续费/支付逻辑依赖Stripe自动生成并处理的非草稿发票，因此该路径无法适配订阅的自动支付需求。

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