Guide d'action

Tracke chaque remboursement avec sa raison et son montant

POST/v1/events · invoice.refunded

Émets un event `invoice.refunded` à chaque remboursement partiel ou total. Inclut la raison, demande client, prélèvement accidentel, chargeback.

Commencer gratuitement Ouvrir le playground

Quand l'émettre

Après que le remboursement soit émis via ton provider et acquitté dans ta base.

Payload d'exemple

await recalled.events.create({
  action: "invoice.refunded",
  actor: { id: user.id, email: user.email },
  organization: user.organizationId,
  metadata: {
    amount: "value",
    currency: "value",
    reason: "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 remboursé en plus petite unité
`currency`	Code ISO 4217
`reason`	requested_by_customer, duplicate, fraudulent, cancelled
`originalInvoiceId`	La facture remboursée

Rétention recommandée

Aligne sur ta rétention comptable, 5 à 10 ans en général.

Actions liées

Logger les factures payées

invoice.paid

Logger les échecs de paiement

invoice.payment_failed