Le solde (balance) d'un compte (et la façon dont il restitué via l'API Accounts) va dépendre de plusieurs facteurs, détaillés ci-dessous :
Statut des transactions
Une transaction peut traverser différents états :
- Prévue : la transaction n’a pas été effectuée mais est programmée. Il peut s'agir typiquement d'un virement programmé ou d'un prélèvement. Cet état implique qu’elle est non comptabilisée.
- Non comptabilisée : la transaction a été effectuée ET est connue de la banque mais n’a pas été “validée” dans l’historique comptable
- Comptabilisée : la transaction a été validée dans l’historique comptable
Sur l'API Accounts, nous matérialisons ces états grâce à l'attribut 'status' des transactions, qui peut être valorisé comme suit :
- OTHER : transaction prévue, non comptabilisée, qui n'impacte aucun solde
- PENDING : transaction non comptabilisée qui impacte le solde instantané seulement
- BOOKED : transaction comptabilisée qui impacte le solde instantané ET le solde comptable
Calcul de la balance côté banque
Sur leur espaces en ligne, les banques peuvent matérialiser le solde (ou balance) des comptes de 2 façons différentes :
- Solde instantané : il tient compte de toutes les opérations effectuées, qu’elles soient comptabilisées ou non. Cela exclut les transactions dites 'prévues', pas encore effectuées: virement programmé, prélèvement mensuel, etc.
- Solde comptable : tient compte uniquement des opérations dites 'comptabilisées'. Cela exclut les chèques encaissés mais pas encore versés sur le compte, les transactions 'prévues' et les encours de carte, entre autres.
Certaines banques font le choix d'afficher le solde comptable, d'autres le solde instantané, et certaines parfois les deux.
Restitution de cette balance sur l'API Accounts
Pour leurs API DSP2, les banques Françaises ont adopté le standard STET, qui prévoit l'exposition de 4 types de balance :
- CLBD : Closing Booked = “solde comptable”
- XPCD : Expected = “solde instantané”
- OTHER : Other = seulement utilisé pour les comptes de type 'CARD' (comptes matérialisant les cartes de crédit)
- VALUE: Value = balance à date de valeur
Il n’existe pas de normes spécifiant quel type de balance doit être remonté par les API des banques. Certaines exposent plusieurs types de balance via leurs APIs respectives, mais une seule est exposée sur l'API Accounts v2.1. A noter que nous envisageons d’exposer les différents types de balance sur la v3, qui arrivera très prochainement.
Pour une synchronisation donnée, notre système va vérifier les soldes qui ont été remontés par l'API de la banque, et les exposer sur Accounts selon cet ordre de priorité :
1 - CLBD
Si non disponible :
2 - XPCD
Si non disponible :
3 - VALUE
Si non disponible :
4 - OTHER
Lien entre statut des transactions et calcul du solde
L'impact des transactions sur les types de solde peut être résumée par le tableau suivant :
|
Transaction comptabilisée |
Soldes tenant compte de la valeur de la transaction (autrement dit: soldes correspondant à la somme des montants des transactions) | Statut utilisé sur l’API Accounts pour représenter cet état | |
| Instantané (XPCD) | Comptable (CLBD) | ||
| Non | Non | Non | OTHER |
| Non | Oui | Non | PENDING |
| Oui | Oui | Oui | BOOKED |
Pour plus d’informations sur le GET /accounts, nous vous invitions à consulter notre DevPortal.