如何从 Stripe 检索交易

我开始检查 stripe 文档以将 stripe billing api 集成到 saas 应用程序中。事情并不总是最简单的，需要一些时间才能理解在 stripe 订阅的上下文中，最接近“交易”的实体是 发票，特别是与之相关的支付事件 -例如付款意图以及由此产生的费用。原因如下：

1. 订阅生命周期：stripe 中的订阅代表一项定期向客户收费的持续协议。然而，订阅本身并不处理实际的金融交易。

2. 发票生成：对于订阅的每个计费周期，stripe 都会生成发票。发票详细列出了所欠金额，包括订阅项目、税费和折扣。

3. 付款处理：当发票最终确定时，stripe 创建一个 付款意图 来处理付款。付款意图封装了付款流程并在需要时处理客户身份验证。

4. 费用创建：支付成功后，会创建一个费用对象。这代表资金从客户账户到应用程序账户的实际转账。

在条带示例中提供的 json 响应中，latest_invoice 字段引用与订阅关联的最新发票：

"latest_invoice": "in_1MowQWLkdIwHu7ixuzkSPfKd"

要查看交易详细信息，我们应该检索此发票并检查其 payment_intent 或费用：

摘要：在 stripe 的订阅工作流程中，发票及其关联的付款意图和费用是实体最接近代表一笔交易。

示例工作流程：

1. 订阅 (sub_...)：管理定期计费协议。
2. 发票（in_...）：为每个计费周期生成；逐项列出费用。
3. 付款意向 (pi_...)：开始收取发票付款。
4. charge (ch_...)：付款成功后创建；代表交易。