Traitement des annulations de plan

L’annulation d’une application GitHub Marketplace déclenche le webhook d’événementmarketplace_purchase avec l’action cancelled, qui lance le processus d’annulation.

Dans cet article

Remarque : cet article s’applique à la publication d’applications dans GitHub Marketplace uniquement. Pour plus d’informations sur la publication de GitHub Actions dans GitHub Marketplace, consultez « Publication d’actions dans GitHub Marketplace ».

Pour plus d’informations sur l’annulation en termes de facturation, consultez « Facturer les clients ».

Étape 1. Événement d’annulation

Si un client choisit d’annuler une commande GitHub Marketplace, GitHub envoie un webhook marketplace_purchase avec l’action cancelled à votre application quand l’annulation prend effet. Si le client annule pendant un essai gratuit, votre application reçoit immédiatement l’événement. Quand un client annule un plan payant, l’annulation se produit à la fin du cycle de facturation du client.

Étape 2. Désactivation des comptes client

Quand un client annule un plan gratuit ou payant, votre application doit effectuer ces étapes pour effectuer l’annulation :

  1. Désactiver le compte du client qui a annulé son plan.
  2. Révoquer le jeton OAuth qu’elle a reçu pour le client.
  3. Si votre application est une OAuth app, supprimez tous les webhooks qu’elle a créés pour les référentiels.
  4. Supprimer toutes les données client dans les 30 jours suivant la réception de l’événement cancelled.

Note

Nous vous recommandons d’utiliser l’objet marketplace_purchase des webhooks effective_date pour déterminer la date du changement de plan, et de synchroniser régulièrement Lister les comptes d’un plan. Pour plus d’informations sur les webhooks, consultez « Événements de webhook pour l’API GitHub Marketplace ».