Charge utile des webhooks d’achat GitHub Marketplace
Les demandes de webhooks POST ont des en-têtes spéciaux. Pour plus d’informations, consultez « Événements et charges utiles du webhook ». GitHub ne renvoie pas les tentatives de remise ayant échoué. Vérifiez que votre application peut recevoir toutes les charges utiles de webhook envoyées par GitHub.
Les annulations et les passages à un plan inférieur sont effectifs le premier jour du cycle de facturation suivant. Les événements pour les passages à un plan inférieur et les annulations sont envoyés quand le nouveau plan prend effet au début du cycle de facturation suivant. Les événements pour les nouveaux achats et les passage à un plan supérieur commencent immédiatement. Utilisez l’objet effective_date de la charge utile du webhook pour savoir quand commence un changement.
Remarque : Si vous remarquez des achats GitHub Marketplace indésirables ou d’autres comportements malveillants, remplissez le formulaire Signaler un abus avec plus d’informations sur l’utilisateur.
Chaque charge utile de webhook marketplace_purchase a les informations suivantes :
| Clé | Type | Description |
|---|---|---|
action | string | Action effectuée pour générer le webhook. Peut être purchased, cancelled, pending_change, pending_change_cancelled ou changed. Pour plus d’informations, consultez les exemples de charge utile de webhook ci-dessous. Remarque : Les charges utiles pending_change et pending_change_cancelled ont les mêmes clés que celles indiquées dans l’exemple de charge utile changed. |
effective_date | string | Date à laquelle l’action prend effet. |
sender | object | Personne responsable de l’action qui a déclenché le webhook. |
marketplace_purchase | object | Informations de l’achat GitHub Marketplace. |
L’objet marketplace_purchase a les clés suivantes :
| Clé | Type | Description |
|---|---|---|
account | object | Compte organization ou user associé à l’abonnement. Les comptes professionnels comprennent organization_billing_email, qui est l’adresse e-mail administrative de l’organisation. Pour rechercher les adresses e-mail des comptes personnels, vous pouvez utiliser le point de terminaison Obtenir l’utilisateur authentifié. |
billing_cycle | string | Peut être yearly ou monthly. Quand le propriétaire de account a un plan GitHub gratuit et a acheté un plan GitHub Marketplace gratuit, billing_cycle est nil. |
unit_count | integer | Nombre d’unités achetées. |
on_free_trial | boolean | true quand account utilise un essai gratuit. |
free_trial_ends_on | string | Date d’expiration de l’essai gratuit. |
next_billing_date | string | Date de début du cycle de facturation suivant. Quand le propriétaire de account a un plan GitHub.com gratuit et a acheté un plan GitHub Marketplace gratuit, next_billing_date est nil. |
plan | object | Plan acheté par user ou organization. |
L’objet plan a les clés suivantes :
| Clé | Type | Description |
|---|---|---|
id | integer | Identificateur unique de ce plan. |
name | string | Nom du plan. |
description | string | Description de ce plan. |
monthly_price_in_cents | integer | Prix mensuel de ce plan en cents (devise américaine). Par exemple, un listing qui coûte 10 dollars USD par mois correspond à 1 000 cents. |
yearly_price_in_cents | integer | Prix annuel de ce plan en cents (devise américaine). Par exemple, un listing qui coûte 100 dollars USD par mois correspond à 120 000 cents. |
price_model | string | Modèle tarifaire de ce listing. Peut être FLAT_RATE, PER_UNIT ou FREE. |
has_free_trial | boolean | true quand ce listing propose un essai gratuit. |
unit_name | string | Nom de l’unité. Si le modèle tarifaire n’est pas per-unit, est égal à nil. |
bullet | array of strings | Noms des puces définies dans le plan tarifaire. |
Exemple de charge utile de webhook pour un événement purchased
Cet exemple fournit la charge utile d’événement purchased.
Exemple de charge utile de webhook pour un événement changed
Les changements de plan sont notamment les passages à un plan supérieur ou inférieur. Cet exemple représente les charges utiles d’événement changed, pending_change et pending_change_cancelled. L’action identifie celui des trois événements qui s’est produit.