Liaison Carte Bancaire - OpenBanking

1.1 Contexte

La liaison de carte bancaire est une fonctionnalité centrale de REWAPP permettant la détection automatique des achats chez les partenaires. Cette fonctionnalité utilise une solution OpenBanking conforme à la directive européenne PSD2 (Payment Services Directive 2).

1.2 Objectif du Flux

Permettre à l'utilisateur de connecter de manière sécurisée son compte bancaire à REWAPP pour :

• Détecter automatiquement les transactions chez les partenaires
• Créditer les points de fidélité correspondants
• Maintenir une expérience utilisateur fluide et sans friction

1.3 Fournisseur Recommandé

• Agrément ACPR (Autorité de Contrôle Prudentiel et de Résolution)
• Couverture de plus de 350 banques françaises
• SDK natif compatible Capacitor
• Conformité PSD2 et RGPD

1.4 Prérequis

• Utilisateur inscrit et email vérifié
• Application mobile installée (iOS 14+ ou Android 10+)
• Compte bancaire actif dans une banque supportée

3.1 Diagramme PlantUML - Première Liaison de Carte

@startuml
skinparam backgroundColor #FFFFFF
skinparam handwritten false
skinparam sequenceArrowThickness 2
skinparam roundcorner 10

skinparam participant {
  BackgroundColor #E8F5E9
  BorderColor #4CAF50
}

title Liaison Carte Bancaire OpenBanking - REWAPP

actor "Client" as user #LightBlue
participant "App Mobile" as app #LightGreen
participant "SDK BI" as sdk #Cyan
participant "API Gateway" as gw #Orange
participant "Service Bancaire" as svc #Yellow
database "PostgreSQL" as db #LightGray
database "Redis" as cache #Pink
participant "Budget Insight" as bi #Green
participant "Banque" as bank #Purple

== Phase 1: Initialisation ==
user -> app : Clic Lier ma carte
app -> gw : POST /api/banking/init-link
gw -> svc : Route vers Service Bancaire
svc -> cache : Creer session temporaire
cache --> svc : sessionId
svc -> bi : POST /auth/init
bi --> svc : authUrl stateToken
svc --> gw : sessionId authUrl
gw --> app : 200 OK

== Phase 2: Auth Bancaire ==
app -> sdk : Lancer SDK Budget Insight
sdk -> bank : Redirection portail bancaire
user -> bank : Saisir identifiants 2FA
bank -> bi : Callback authorization_code

== Phase 3: Consentement ==
bank -> bank : Ecran consentement PSD2
user -> bank : Accepter consentement
bi -> bi : Echanger code contre tokens
sdk --> app : Callback SUCCESS

== Phase 4: Enregistrement ==
app -> gw : POST /api/banking/complete-link
svc -> svc : Chiffrer tokens AES-256
svc -> db : INSERT bank_connections

== Phase 5: Webhooks ==
svc -> bi : POST /webhooks/register
bi --> svc : webhookId ACTIVE

== Phase 6: Confirmation ==
svc --> app : 200 OK success
app -> user : Carte liee avec succes

@enduml

4.1Phase 1 : Initialisation

4.2Phase 2 : Authentification Bancaire

4.3Phase 3 : Consentement et Autorisation

4.4Phase 4 : Enregistrement

4.5Phase 5 : Configuration Webhooks

4.6Phase 6 : Confirmation

5.1Reconnexion de Carte (Token Expiré)

@startuml
skinparam backgroundColor #FFFFFF

title Reconnexion Carte Bancaire (Consentement Expiré - 90 jours)

actor "Client" as user
participant "Application Mobile" as app
participant "Service Bancaire" as svc
database "PostgreSQL" as db
participant "Budget Insight API" as bi

== Détection Expiration ==
svc -> bi : GET /connections/{id}/status
bi --> svc : {status: EXPIRED}
svc -> db : UPDATE bank_connections SET status = RECONNECT_REQUIRED
svc -> app : Push Notification: "Reconnectez votre carte"

== Flux Reconnexion ==
user -> app : Clic "Reconnecter"
app -> svc : POST /api/banking/reconnect
svc -> bi : POST /connections/{id}/renew
bi --> svc : {authUrl}

note over app, bi: Reprise du flux OAuth2 (Phases 2-3)

== Finalisation ==
bi --> svc : Callback succès {newTokens}
svc -> db : UPDATE bank_connections SET status = ACTIVE
svc --> app : Succès reconnexion
app -> user : "Carte reconnectée !"

@enduml

5.2Ajout d'une Carte Supplémentaire

5.3Suppression de Carte

6.1Erreurs d'Authentification Bancaire

6.2Erreurs de Consentement

6.3Erreurs Techniques

7.1Mesures de Sécurité Implémentées

7.2Conformité PSD2

7.3Conformité RGPD

7.4Protection des Données Sensibles

8.1Requête Initialisation

8.2Réponse Initialisation

8.3Requête Finalisation

8.4Réponse Finalisation

{
  "success": true,
  "cardInfo": {
    "bankName": "BNP Paribas",
    "cardMask": "•••• 1234",
    "isPrimary": true,
    "linkedAt": "2025-11-24T10:30:00Z",
    "expiresAt": "2026-02-22T10:30:00Z"
  }
}

8.5Payload Webhook Transaction

{
  "eventType": "TRANSACTION_CREATED",
  "connectionId": "conn_abc123",
  "transaction": {
    "id": "txn_xyz789",
    "amount": 45.90,
    "currency": "EUR",
    "date": "2025-11-24T14:30:00Z",
    "merchantName": "Carrefour City",
    "merchantId": "merchant_123"
  },
  "signature": "hmac_sha256_signature"
}

9.1Points Clés du Flux

• Sécurité maximale : Identifiants bancaires jamais exposés aux serveurs REWAPP
• Conformité réglementaire : PSD2, RGPD, agrément ACPR via Budget Insight
• Expérience utilisateur fluide : SDK natif intégré, processus guidé
• Multi-cartes supporté : Aucune limite sur le nombre de cartes
• Renouvellement automatique : Alertes avant expiration (90 jours)
• Révocation simple : Suppression possible à tout moment

9.2Métriques de Suivi

9.3Checklist d'Implémentation

• Configuration SDK Budget Insight (iOS + Android)
• Endpoints API Gateway configurés
• Service Bancaire microservice déployé
• Tables PostgreSQL créées (bank_connections, linked_cards)
• Redis configuré pour sessions temporaires
• Chiffrement AES-256 implémenté
• Webhooks enregistrés avec Budget Insight
• Gestion d'erreurs complète
• Logs et monitoring configurés (CloudWatch, Sentry)
• Tests de bout en bout validés (sandbox)