如何生成Stripe草稿发票(draft invoice)的PDF文件
Stripe草稿发票PDF下载问题解答
结论先行:Stripe原生的API和管理后台(Dashboard)都不支持直接下载draft状态发票的PDF。
官方设计的原因
Stripe的发票流转逻辑中,draft状态属于可编辑阶段,发票的交易明细、金额、收付款方信息、税率等所有内容都可以随时调整,不具备正式法律效应,因此官方不会为草稿状态的发票生成固定的PDF文件和托管页面,这也是你在发票确认前invoice_pdf和hosted_invoice_url两个字段均返回null的原因。
可行的替代方案
如果需要预览草稿发票的PDF效果,可以根据你的使用场景选择对应方案:
- 低频次场景:临时确认后作废
先对目标草稿发票执行最终确认操作,待状态更新为open、获取到PDF文件后,立刻将该发票标记为void(作废)即可。整个操作不会触发实际的收款流程,也不会对客户产生通知,适合偶尔需要预览少量草稿发票的情况,不需要额外开发。 - 高频次场景:自行生成预览PDF
你可以直接读取draft状态发票的所有字段数据,包括商品项、金额、税率、客户信息、自定义备注等,自行对接PDF生成工具按照你需要的发票样式生成预览文件,不需要修改发票本身的状态,适合有大量草稿预览需求的业务场景。
内容的提问来源于stack exchange,提问作者jhselvik
相关产品推荐
相关产品推荐

