Le payload envoyé à votre point de terminaison webhook lorsqu’un événement de facturation basé sur les crédits se produit — crédits virtuels (appels d’API, jetons, heures de calcul) accordés, consommés, expirés, reportés ou alertes de solde. Ces webhooks ne sont pas liés aux Customer Wallets (soldes monétaires).
| Événement | Description |
|---|---|
credit.added | Des crédits sont accordés à un client (via abonnement, achat ponctuel, module complémentaire ou API) |
credit.deducted | Les crédits sont consommés par l’utilisation ou un débit manuel |
credit.expired | Les crédits non utilisés expirent après la période d’expiration configurée |
credit.rolled_over | Les crédits non utilisés sont reportés sur une nouvelle attribution à la fin du cycle |
credit.rollover_forfeited | Crédits confisqués car le nombre maximal de reports a été atteint |
credit.overage_charged | Des frais supplémentaires sont appliqués lorsque l’utilisation se poursuit au-delà d’un solde nul |
credit.manual_adjustment | Ajustement manuel de crédit ou de débit effectué via le tableau de bord ou l’API |
credit.balance_low | Le solde de crédit tombe en dessous du seuil de solde bas configuré |
credit.added à credit.manual_adjustment) partagent la même charge utile CreditLedgerEntryResponse documentée dans le schéma ci-dessous.
credit.balance_low utilise une charge utile différente (CreditBalanceLowPayload) axée sur les alertes de seuil :
credit.balance_low pour les alertes proactivescredit.balance_low pour informer les clients avant qu’ils n’épuisent leurs crédits :
Response for a ledger entry
credit_added, credit_deducted, credit_expired, credit_rolled_over, rollover_forfeited, overage_charged, auto_top_up, manual_adjustment, refund