为什么我的Stripe发票hosted_invoice_url字段值为null？

核心原因 #

hosted_invoice_url 为 null 和 Stripe 后台配置无关，完全是由你当前发票的草稿状态导致的。Stripe 官方规则明确：只有发票完成最终定稿、状态从 draft 变更为 open 后，才会生成对应的客户可访问托管页面，此时该字段才会返回有效链接。你调用 Stripe.InvoiceService.ListAutoPagingAsync 方法本身没有问题，所有API接口在发票为草稿状态时都会返回该字段为 null。

解决方法 #

如果需要获取有效 hosted_invoice_url，你需要先对草稿发票执行定稿操作，C# 示例代码如下：

var invoiceService = new InvoiceService();
// 传入目标草稿发票的ID执行定稿
var finalizedInvoice = await invoiceService.FinalizeAsync(
  "in_xxxxxx", // 替换为你的发票ID
  new InvoiceFinalizeOptions { 
    AutoAdvance = true // 可选参数，配置是否自动触发发票发送、催收等后续流程
  }
);
// 定稿后即可直接读取到URL
var validHostedUrl = finalizedInvoice.HostedInvoiceUrl;

补充说明 #

如果暂时不需要对外发送发票、不希望定稿，仅需要内部预览草稿效果，只能通过Stripe后台的发票预览页面查看，API层面不会对外暴露草稿状态的公开托管链接。

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