Guide d'action

Un trail papier pour chaque facture réglée par ton provider

POST/v1/events · invoice.paid

Émets un event `invoice.paid` depuis ton handler webhook Stripe (ou autre provider). Stocke le montant, la devise, l'ID event provider et l'organisation du client.

Commencer gratuitement Ouvrir le playground

Quand l'émettre

Dans le handler webhook qui traite l'event `invoice.payment_succeeded` de ton provider. Toujours émettre après que ton propre write en base ait réussi.

Payload d'exemple

await recalled.events.create({
  action: "invoice.paid",
  actor: { id: user.id, email: user.email },
  organization: user.organizationId,
  metadata: {
    amount: "value",
    currency: "value",
    providerEventId: "value"
  },
});

Metadata à inclure

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

Clé	Rôle
`amount`	Montant en plus petite unité (centimes)
`currency`	Code ISO 4217, usd, eur, gbp
`providerEventId`	Stripe evt_xxx ou équivalent
`invoiceNumber`	Ton propre numéro de facture interne

Rétention recommandée

Garder 5 à 10 ans selon les obligations comptables de ta juridiction.

Actions liées

Logger les remboursements

invoice.refunded

Logger les upgrades d'abonnement

subscription.upgraded

Logger les échecs de paiement

invoice.payment_failed