Skip to main content

​
Objectif

Cette section définit les **règles de gestion des erreurs **applicables à tous les échanges entre la Banque et le Connecteur Bancaire. Elle vise à garantir :
  • une interprétation univoque des erreurs,
  • une gestion cohérente des rejets,
  • une traçabilité complète pour les équipes techniques et support.

​
Principes fondamentaux

  • Toute erreur doit être déterministe
  • Toute erreur doit être tracable
  • Une erreur de sécurité entraîne un **rejet immédiat**
  • Une erreur finale est **non rejouable**, sauf indication contraire

​
Catégorisation des erreurs

Typologie des erreurs supportées

​
Catégories

Les erreurs sont classées en trois catégories :

​
1. Erreurs de sécurité (`SECURITY`)

Erreurs liées à :
  • l’authentification,
  • la signature,
  • l’anti-rejeu,
  • l’intégrité des messages.
Ces erreurs entraînent un **rejet immédiat**.

​
2. Erreurs techniques (`TECHNICAL`)

Erreurs liées à :
  • indisponibilité système,
  • timeout,
  • erreurs réseau,
  • erreurs de format non métier.
Ces erreurs peuvent être **rejouées**.

​
3. Erreurs métier (`BUSINESS`)

Erreurs liées à :
  • règles bancaires,
  • solde insuffisant,
  • compte invalide,
  • devise non supportée.
Ces erreurs sont **définitives**.

​
5.5 Codes d’erreurs — Métier

​
errors/business-errors.mdx

---
title: Codes d’erreurs métier
description: Erreurs liées aux règles bancaires
---

| Code | Type | Description |
|----|------|-------------|
| BUS_001 | BUSINESS | Solde insuffisant |
| BUS_002 | BUSINESS | Compte débiteur invalide |
| BUS_003 | BUSINESS | Compte bénéficiaire invalide |
| BUS_004 | BUSINESS | Devise non supportée |
| BUS_005 | BUSINESS | Plafond dépassé |

---

## Règles

- Les erreurs métier sont **définitives**
- Aucun retry automatique n’est autorisé
- Le statut final est `FAILED`

​
5.6 Correspondance HTTP / Erreurs

​
errors/http-mapping.mdx

---
title: Mapping HTTP et erreurs
description: Correspondance entre codes HTTP et erreurs métier
---

| HTTP | Catégorie | Signification |
|----|-----------|----------------|
| 200 | - | Traitement réussi |
| 202 | - | Traitement accepté |
| 400 | BUSINESS | Erreur métier |
| 401 | SECURITY | Authentification échouée |
| 403 | SECURITY | Accès interdit |
| 409 | TECHNICAL | Conflit / Idempotence |
| 500 | TECHNICAL | Erreur interne |
| 503 | TECHNICAL | Service indisponible |

​
5.7 Traçabilité des erreurs

​
errors/error-tracking.mdx

---
title: Traçabilité et support
description: Suivi et analyse des erreurs
---

## Identification

Chaque erreur doit être associée à :
- `messageId`
- `correlationId`
- horodatage UTC

---

## Support et diagnostic

Les informations doivent permettre :
- l’identification rapide de la cause,
- la reconstitution du flux,
- la résolution des incidents.

---

## Audit

Les erreurs doivent être conservées conformément
aux exigences réglementaires et contractuelles.

​
Résultat

  • Section 5 complètement structurée
  • Codification claire et exploitable
  • Prête pour :
    • implémentation
    • tests d’intégration
    • procédures support & run