处理计划取消

取消 GitHub Marketplace 应用会触发 marketplace_purchase 事件 webhook，其中包含 cancelled 操作，该操作会启动取消流程。

本文内容

注意：本文仅适用于在 GitHub Marketplace 中发布应用。有关在 GitHub Marketplace 中发布 GitHub Actions 的详细信息，请参阅“在 GitHub Marketplace 中发布 Actions”。

有关与计费相关的取消的详细信息，请参阅“向客户开具账单”。

步骤 1. 取消事件

如果客户选择取消 GitHub Marketplace 订单，GitHub 会在取消生效时向你的应用发送一个操作为 cancelled 的 marketplace_purchase webhook。如果客户在免费试用期间取消，你的应用会立即收到该事件。当客户取消付费计划时，取消将在客户的计费周期结束时发生。

步骤 2. 停用客户帐户

当客户取消免费或付费套餐时，您的应用必须执行以下步骤以完成取消

  1. 停用取消套餐的客户的帐户。
  2. 撤销您的应用为该客户收到的 OAuth 令牌。
  3. 如果您的应用是 OAuth 应用，请移除您的应用为存储库创建的所有 Webhook。
  4. 在收到cancelled事件后 30 天内移除所有客户数据。

注意：我们建议使用 marketplace_purchase Webhook 的 effective_date 来确定套餐变更何时发生，并定期同步 列出套餐的帐户。有关 Webhook 的更多信息，请参阅“GitHub Marketplace API 的 Webhook 事件”。