处理计划取消

本文内容

取消 GitHub Marketplace 应用会触发 marketplace_purchase 事件 Webhook 和 cancelled 操作，该操作会启动取消流。

注意：本文适用于仅在 GitHub Marketplace 中发布 GitHub Apps 的情况。 若要详细了解如何在 GitHub Marketplace 中发布 GitHub Actions，请参阅“在 GitHub Marketplace 中发布操作”。

有关与计费相关的取消的更多信息，请参阅“向客户计费”。

步骤 1。 取消事件

如果客户选择取消 GitHub Marketplace 订单，则在取消生效时，GitHub 会向你的应用发送带有操作 cancelled 的 marketplace_purchase Webhook。 如果客户在免费试用期间取消，您的应用程序将立即收到此事件。 如果客户取消付费计划，则取消将在客户结算周期结束时生效。

步骤 2. 停用客户帐户

当客户取消免费或付费计划时，您的应用程序必须执行以下步骤才能完成取消：

  1. 停用取消计划的客户的帐户。
  2. 撤消您的应用程序为客户接收的 OAuth 令牌。
  3. 如果你的应用是 OAuth app，则删除应用为存储库创建的所有 web 挂钩。
  4. 在收到 cancelled 事件后的 30 天内删除所有客户数据。

注意：建议使用 marketplace_purchase webhook 的 effective_date 来确定计划更改的时间并定期同步计划的帐户列表。 有关 Webhook 的详细信息，请参阅“GitHub Marketplace API 的 web 挂钩事件”。