Stripe单次付费非订阅场景下InvoicePdf返回null问题及实现

问题核心原因 #

• 错误将InvoiceItem对象的ID作为Invoice对象的ID查询。InvoiceItem是预存储的待收费条目，本身不绑定正式发票实体，自然获取不到有效发票数据。
• 直接创建Invoice的操作默认生成草稿状态发票，该阶段Stripe不会生成可下载的PDF文件，InvoicePdf字段固定返回null。

正确实现步骤 #

全流程无需依赖订阅逻辑，按以下步骤操作即可稳定获取正式Invoice ID和对应InvoicePdf：

1. 创建商品与定价，逻辑与现有代码一致

   // 初始化商品
   var productService = new ProductService();
   var product = productService.Create(new ProductCreateOptions
   {
       Name = "Starter Setup"
   });
   
   // 初始化对应价格
   var priceService = new PriceService();
   var price = priceService.Create(new PriceCreateOptions
   {
       Product = product.Id,
       UnitAmount = 2000,
       Currency = "usd"
   });
   

2. 创建客户并绑定前端传入的支付方式token，逻辑与现有代码一致

   var customerService = new CustomerService();
   var customer = customerService.Create(new CustomerCreateOptions
   {
       Email = model.Mail,
       Name = model.FullName, // 原代码此处疑似拼写笔误FuldName
       Source = token
   });
   

3. 为客户添加待计费条目，无需留存条目ID用于后续查询发票

   var invoiceItemService = new InvoiceItemService();
   invoiceItemService.Create(new InvoiceItemCreateOptions
   {
       Customer = customer.Id,
       Price = price.Id,
       Quantity = 1
   });
   

4. 创建发票并完成最终化操作（原代码缺失的核心步骤）

   var invoiceService = new InvoiceService();
   // 创建发票，配置自动扣款规则
   var invoice = invoiceService.Create(new InvoiceCreateOptions
   {
       Customer = customer.Id,
       AutoAdvance = true,
       CollectionMethod = "charge_automatically" // 发票最终化后自动从客户绑定的支付方式扣款
   });
   
   // 关键操作：将草稿状态的发票推进为最终状态，触发InvoicePdf生成
   invoice = invoiceService.FinalizeInvoice(invoice.Id, new InvoiceFinalizeOptions
   {
       AutoAdvance = true
   });
   
   // 此时可正常取值，直接存入数据库即可
   var validInvoiceId = invoice.Id;
   var validInvoicePdf = invoice.InvoicePdf;
   

常见踩坑提醒 #

• 绝对不要跳过发票最终化步骤：只要发票处于草稿状态，无论调用多少次查询接口，InvoicePdf都会返回null。
• 若最终化后短时间查询仍返回null，可手动调用一次invoiceService.Get(invoice.Id)重新拉取最新数据，PDF生成仅需极短处理时间。
• 之前通过单次订阅实现时能正常拿到PDF，是因为Stripe在创建订阅的流程中已经自动完成了发票创建、最终化、扣款的全链路操作，不需要手动补步骤，并非订阅流程本身有特殊逻辑。

内容的提问来源于stack exchange，提问作者J. Petersen