Skip to main content

Behandeln von Plankündigungen

Durch die Kündigung einer GitHub Marketplace-App wird der marketplace_purchase-Ereigniswebhook mit der Aktion cancelled ausgelöst, wodurch der Kündigungsprozess gestartet wird.

Hinweis: Dieser Artikel gilt nur für die Veröffentlichung von GitHub Apps im GitHub Marketplace. Weitere Informationen zum Veröffentlichen von GitHub Actions im GitHub Marketplace findest du unter Aktionen auf dem GitHub-Marktplatz veröffentlichen.

Weitere Informationen zu Kündigungen im Zusammenhang mit der Abrechnung findest du unterAbrechnung mit Kunden.

Schritt 1: Kündigungsereignis

Wenn ein Kunde eine GitHub Marketplace-Bestellung kündigt, sendet GitHub einen marketplace_purchase-Webhook mit der cancelled-Aktion an deine App, sobald die Kündigung wirksam wird. Wenn der Kunde während einer kostenlosen Testperiode kündigt, erhält deine App das Ereignis sofort. Wenn ein Kunde einen kostenpflichtigen Plan kündigt, erfolgt die Kündigung zum Ende des Abrechnungszeitraums des Kunden.

Schritt 2: Deaktivieren von Kundenkonten

Wenn ein Kunde einen kostenlosen oder kostenpflichtigen Plan kündigt, muss deine App die folgenden Schritte zum Abschließen der Kündigung ausführen:

  1. Das Konto des Kunden deaktivieren, der seinen Plan gekündigt hat.
  2. Das OAuth-Token widerrufen, das deine App für den Kunden erhalten hat.
  3. Wenn es sich bei deiner App um eine OAuth app handelt, entferne alle Webhooks, die deine App für Repositorys erstellt hat.
  4. Alle Kundendaten innerhalb von 30 Tagen nach Erhalt des cancelled-Ereignisses entfernen.

Hinweis: Es wird empfohlen, effective_date des marketplace_purchase-Webhooks zu verwenden, um festzustellen, wann eine Planänderung eintritt, und die Auflistung von Konten für einen Plan regelmäßig zu synchronisieren. Weitere Informationen zu Webhooks findest du unter Webhook-Ereignisse für die GitHub Marketplace-API.