缺乏使用 SubscriptionItemUsageRecordService.Create() 的文档和问题

Question

我需要帮助添加客户的计量使用情况（这是基于计量使用情况的订阅项目计数）。

根据创建使用记录的文档，我创建了以下代码。

SubscriptionItemUsageRecordCreateOptions options = new()
{
    Quantity = count,
    Timestamp = DateTime.UtcNow
};

SubscriptionItemUsageRecordService service = new();
await service.CreateAsync("xxxx", options);

问题：

1. CreateAsync()

   的第一个参数的标题为

   parentId

   。但对此没有任何解释，并且在帮助中搜索

   SubscriptionItemUsageRecordService

   也没有返回任何结果。我有一个客户 ID。我如何获得这里的值？

2. 检测成功或失败的正确方法是什么？我知道这个方法可以抛出异常，但它也可以返回 null。我很困惑为什么 Stripe 没有一致的成功/失败约定（并且没有更好的文档记录）。

Answer 1

“parent id”表示创建UsageRecord的对象的id。在该 API 上，UsageRecord 与 SubscriptionItem 关联，因此父 ID 应该是该 SubscriptionItem 中的

si_1234

。您可以在 Stripe 的 API 参考文档此处中查看它。

Stripe 还提供了UsageRecord 的端到端指南：https://docs.stripe.com/billing/subscriptions/usage-based-legacy/recording-usage

请注意，Stripe 认为此集成已弃用/遗留。几个月前，他们重新设计了整个基于使用情况的计费 API。如果您刚刚开始，您应该查看较新的 API：https://docs.stripe.com/billing/subscriptions/usage-based

关于失败，如果请求失败，Stripe 会抛出异常。请参阅有关错误处理的详细文档：https://docs.stripe.com/error-handling