Guide d'action

Capture la raison quand un client s'en va

POST/v1/events · subscription.cancelled

Émets un event `subscription.cancelled` dès qu'un client demande à annuler, même avant la fin de période. Stocke la raison issue de ton flow d'annulation si tu en as un.

Commencer gratuitement Ouvrir le playground

Quand l'émettre

Juste après l'acceptation de la demande d'annulation, le client est encore au milieu du flow, donc tu sais exactement quelle raison il a choisie.

Payload d'exemple

await recalled.events.create({
  action: "subscription.cancelled",
  actor: { id: user.id, email: user.email },
  organization: user.organizationId,
  metadata: {
    reason: "value",
    comment: "value",
    atPeriodEnd: "value"
  },
});

Metadata à inclure

Garde les metadata plates et cohérentes dans ton service pour que recherche et exports CSV fonctionnent bien.

Clé	Rôle
`reason`	too_expensive, missing_feature, switching_tools, not_using, other
`comment`	Commentaire libre laissé par le client
`atPeriodEnd`	Si l'annulation prend effet en fin de période

Rétention recommandée

Garder pour toujours, les raisons de churn valent de l'or.

Actions liées

Logger les upgrades d'abonnement

subscription.upgraded

Logger les remboursements

invoice.refunded