# 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](/v1.0/glossaire#client), soit à un [réseau](/v1.0/glossaire#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 `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

- [Tarification des opérations](/v1.0/credits/tarification-des-operations)
- [Suivre votre consommation](/v1.0/credits/suivre-votre-consommation)
- [Référence des crédits](/v1.0/credits/reference)
