Guide d'action

Prouve qu'un client est passé du plan X au plan Y, et quand

POST/v1/events · subscription.upgraded

Émets un event `subscription.upgraded` à chaque passage à un plan supérieur. Garde les slugs from/to dans les metadata pour l'analyse de cohortes.

Commencer gratuitement Ouvrir le playground

Quand l'émettre

Après que le provider ait confirmé la mise à jour et que ta base soit synchro.

Payload d'exemple

await recalled.events.create({
  action: "subscription.upgraded",
  actor: { id: user.id, email: user.email },
  organization: user.organizationId,
  metadata: {
    fromPlan: "value",
    toPlan: "value",
    mrrDelta: "value"
  },
});

Metadata à inclure

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

Clé	Rôle
`fromPlan`	Slug du plan avant le changement
`toPlan`	Slug du plan après le changement
`mrrDelta`	Delta de revenu récurrent en plus petite unité

Rétention recommandée

Garder pour toujours, l'historique des changements de plan est précieux pour l'analyse churn/LTV.

Actions liées

Logger les annulations d'abonnement

subscription.cancelled

Logger les factures payées

invoice.paid