Soldes et transactions
Qui porte un solde de crédits, comment il est débité et crédité, et ce que contient chaque transaction.
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 :
| Compteur | Libellé dans la console | Signification |
|---|---|---|
balance | Solde actuel | Crédits disponibles maintenant |
totalSpent | Total consommé | Cumul des crédits débités depuis l'ouverture du solde |
totalBought | Total 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
| Type | Libellé dans la console | Effet sur le solde |
|---|---|---|
DEBIT | Débit | Diminue : une opération a été facturée |
CREDIT | Crédit | Augmente : achat d'un pack |
ADJUSTMENT | Ajustement | Correction appliquée par Wakastart |
REFUND | Remboursement | Augmente : 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
DEBITd'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.