Skip to content

Soldes et transactions

Qui porte un solde de crédits, comment il est débité et crédité, et ce que contient chaque transaction.

ConceptAdministrator

This page has not been translated yet and is shown in French.

Un solde de crédits appartient à une organisation, et chaque mouvement de ce solde est enregistré comme une transaction. Cette page explique ces deux objets et leurs règles.

Définition

Un solde est le nombre de crédits dont dispose une organisation. Il appartient soit à un client, soit à un réseau. Chaque solde tient trois compteurs :

CompteurLibellé dans la consoleSignification
balanceSolde actuelCrédits disponibles maintenant
totalSpentTotal consomméCumul des crédits débités depuis l'ouverture du solde
totalBoughtTotal rechargéCumul des crédits ajoutés

Une transaction est un mouvement du solde : débit, crédit, ajustement, remboursement ou transfert. Elle porte le montant, le solde après l'opération, le code de l'opération facturée et la date.

Un crédit n'est pas une somme d'argent : c'est une unité de consommation, achetée par packs à un prix fixé.

Pourquoi des crédits

Les services à l'usage ont des coûts variables. Les crédits vous donnent un budget prépayé, consommé au fil de l'eau, sans facture à la fin du mois : vous voyez à tout moment ce qui reste et ce qui a été consommé.

Comment ça marche

Le solde utilisé

Les opérations de vos applications, comme l'analyse antivirus, débitent le solde du client concerné. La console affiche le solde du client auquel votre compte est rattaché.

Le solde est créé au premier besoin, à zéro. Un client qui n'a jamais acheté ni consommé de crédits voit donc un solde de 0.

Le débit

Au moment d'une opération facturée, Wakastart lit le prix de l'opération, vérifie que le solde suffit, puis débite dans la même opération atomique : deux opérations simultanées ne peuvent pas consommer les mêmes crédits.

Si le solde est insuffisant, l'opération est refusée avec une erreur 402 qui indique le nombre de crédits nécessaires et le nombre disponible. Rien n'est débité.

Le crédit

Après le paiement d'un pack, Wakastart crédite le solde du nombre de crédits du pack. Le crédit est automatique ; il intervient en général quelques secondes après le retour de Stripe. Un même paiement ne crédite jamais deux fois le solde.

Les types de transactions

TypeLibellé dans la consoleEffet sur le solde
DEBITDébitDiminue : une opération a été facturée
CREDITCréditAugmente : achat d'un pack
ADJUSTMENTAjustementCorrection appliquée par Wakastart
REFUNDRemboursementAugmente : crédits rendus
TRANSFER_OUT / TRANSFER_IN—Transfert d'un solde de réseau vers un solde de client

La conservation de l'historique

Les transactions restent consultables dans la console pendant 30 jours. Au-delà, elles sont archivées hors ligne, dans un stockage non modifiable conservé 7 ans, et n'apparaissent plus dans la console. Le solde et ses compteurs, eux, ne changent pas.

Exemples

  • Une wakapp qui reçoit des justificatifs fait analyser chaque fichier par l'antivirus. 340 fichiers reçus dans le mois donnent 340 transactions DEBIT d'un crédit chacune.
  • Un solde épuisé : l'analyse suivante répond 402. Après l'achat d'un pack Starter, le solde remonte à 100 et les analyses reprennent.

Pour aller plus loin