处理计划取消

取消 GitHub Marketplace 应用会触发带有 `cancelled` 操作的 marketplace_purchase 事件 Webhook，从而启动取消流程。

本文内容

注意

本文仅适用于在 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 事件”。