🔐 Mettre en place une connexion EBICS T (récupération des comptes bancaires)
📖 EBICS (Electronic Banking Internet Communication Standard) est un protocole de communication bancaire de niveau professionnel, conçu pour les échanges de masse entre une entreprise et sa banque. Comparé à la DSP2, il offre une fiabilité supérieure, des volumes plus importants, l'accès aux relevés MT940 / CAMT.053, et ne nécessite aucun renouvellement de consentement tous les 180 jours.
Cet article décrit la mise en place d'une connexion EBICS T (Transport), qui permet la récupération automatique des soldes et transactions de vos comptes bancaires dans Fygr. La signature des virements (EBICS TS) fait l'objet d'un article séparé.
📋 Prérequis : souscrire un contrat EBICS auprès de votre banque
⏳ La souscription d'un contrat EBICS est une démarche bancaire qui prend en général 2 à 6 semaines selon les établissements. Anticipez cette étape : aucune intégration n'est possible côté Fygr tant que le contrat n'est pas actif côté banque.
Demande à formuler à votre banque
Contactez votre chargé d'affaires entreprise ou le service back-office de votre banque et demandez la mise en place d'un contrat EBICS T (souvent appelé "abonnement EBICS T", "convention EBICS Transport", ou simplement "EBICS T") en précisant les informations suivantes :
Information | Valeur à indiquer | Commentaire |
Type de contrat | EBICS T (Transport) | Pour la récupération de soldes et transactions. EBICS TS est nécessaire en plus uniquement pour signer les virements. |
Version du protocole | H005 (recommandée) | Fygr supporte les trois versions. H005 est la plus récente et la plus sécurisée — privilégiez-la si votre banque la propose. |
Comptes à inclure | Liste des IBAN à connecter | Indiquez explicitement chaque IBAN. Tout compte non listé au contrat ne sera pas synchronisable. |
Ordres autorisés | STA (relevés MT940) | A minima STA ou C53 pour les relevés quotidiens. Les autres ordres améliorent la fraîcheur des données. |
Certificat de signature | 3SKey (recommandé) | Voir section suivante. Le 3SKey est un standard SWIFT reconnu par la quasi-totalité des banques. |
📖 Pourquoi EBICS T plutôt que TS ? EBICS T ne porte que la collecte de données (lecture). EBICS TS ajoute une couche de signature qualifiée pour émettre des virements. Si votre cas d'usage Fygr est uniquement le suivi de trésorerie, EBICS T est suffisant et plus rapide à mettre en place.
🔑 Obtenir et exporter votre certificat 3SKey
📖 3SKey est une clé cryptographique sur support USB (token) émise par SWIFT et distribuée par les banques. C'est le standard de signature personnelle (Personal Signature) reconnu par l'ensemble des banques européennes. Chaque clé est nominative et liée à une personne physique.
1. Récupérer votre clé auprès de votre banque
Votre banque vous remet la clé USB 3SKey ainsi qu'un code PIN d'activation. À la première utilisation, vous devrez activer la clé sur le portail www.3skey.com et personnaliser votre PIN.
2. Exporter le certificat public depuis la clé 3SKey
Une fois la clé activée, exportez le certificat public (fichier .cer ou .pem) afin de pouvoir le transmettre à Fygr et à votre banque. SWIFT met à disposition un tutoriel vidéo officiel détaillant la procédure :
🎥 Tutoriel vidéo SWIFT : Comment exporter votre certificat 3SKey (FR)
⚠️ Ne transmettez jamais votre clé USB physique ni votre PIN. Seul le certificat public doit être communiqué à Fygr et à votre banque. La clé privée reste exclusivement sur votre support 3SKey.
📤 Transmettre les informations à Fygr
Une fois le contrat EBICS souscrit auprès de votre banque et le certificat 3SKey exporté, transmettez à votre interlocuteur Fygr (ou à [email protected]) les éléments suivants :
Information | Exemple | Où la trouver ? |
Host ID |
| Sur le contrat EBICS remis par la banque. Identifie le serveur EBICS de la banque. |
Partner ID |
| Sur le contrat. Identifie votre entreprise auprès de la banque. |
User ID |
| Sur le contrat. Identifie l'utilisateur (= la personne physique) titulaire de la clé 3SKey. |
URL du serveur EBICS | Sur le contrat. Point de terminaison HTTPS à contacter. | |
Version EBICS |
| Sur le contrat ou auprès de votre chargé d'affaires. |
Certificat 3SKey (public) | Fichier | Exporté depuis votre clé 3SKey (voir section précédente). |
Liste des IBAN à connecter |
| Tels que listés dans votre contrat EBICS. |
📖 Le Host ID, le Partner ID et le User ID sont systématiquement présents sur le document contractuel que la banque vous remet à la signature de la convention EBICS. Si vous ne les trouvez pas, demandez le "récapitulatif technique" ou la "fiche d'identification EBICS" à votre banque.
🚀 Initialisation de la connexion et lettre INI
Une fois les informations transmises, Fygr enregistre votre profil EBICS et procède à l'initialisation de la connexion. Cette étape échange les clés publiques entre Fygr et le serveur EBICS de votre banque (ordres INI, HIA, puis HPB).
À l'issue de cette initialisation, Fygr vous remet une lettre d'initialisation EBICS (parfois appelée "lettre INI" ou "lettre de clés") qui contient les empreintes (hashes) de vos clés publiques au format hexadécimal. Cette lettre doit être :
Imprimée et signée par le titulaire du User ID (la personne physique associée à la clé 3SKey) ;
Transmise à votre banque par le canal qu'elle vous a indiqué (courrier postal, dépôt en agence, ou portail bancaire selon les établissements) ;
Validée par la banque, qui activera alors votre accès EBICS sur ses serveurs.
📖 Pourquoi une lettre signée ? Ce processus papier est imposé par la norme EBICS. Il permet à la banque de vérifier en personne que la clé reçue électroniquement correspond bien à celle détenue par le titulaire. C'est l'équivalent du "scellement" d'un contrat bancaire à distance.
⚠️ Cas particulier CIC et BRED. Ces deux banques utilisent un mode de calcul d'empreinte spécifique (hash SHA-256 du certificat complet, et non des composantes exposant/modulus de la clé). Fygr applique automatiquement le bon format dans la lettre INI — assurez-vous simplement que la banque indiquée à votre interlocuteur Fygr est correcte.
✅ Activation et premier rapatriement
Une fois la lettre validée par votre banque (délai indicatif : 3 à 10 jours ouvrés), Fygr déclenche le premier rapatriement de l'historique bancaire (généralement les 90 derniers jours, selon les politiques de votre banque). Les comptes connectés apparaissent ensuite dans votre Dashboard Fygr aux côtés de vos autres comptes.
Le rafraîchissement automatique s'effectue ensuite une à plusieurs fois par jour, sans aucune action de votre part.
💳 Validation des virements (cas EBICS TS)
📖 Cette section ne concerne que les clients ayant souscrit un contrat EBICS TS en plus du contrat EBICS T, et qui utilisent Fygr pour émettre des virements depuis la plateforme.
Cas 1 — Clé 3SKey absente ou non initialisée
Si vous tentez de valider un virement sans avoir de clé 3SKey active sur votre compte utilisateur, ou sans que votre connexion utilisateur ait été initialisée, vous verrez l'écran suivant :
⚠️ Cas des utilisateurs multi-entités. Une clé 3SKey est associée à chaque e-mail. Lorsque vous ajoutez une nouvelle entité à votre périmètre, vous devez explicitement demander à notre support l'activation de la clé pour cette nouvelle entité, même si la clé physique reste la même.
Cas 2 — Clé 3SKey fonctionnelle
Lorsque votre clé est correctement enregistrée et initialisée, vous verrez au moment de valider un virement un écran de confirmation rappelant le montant, le bénéficiaire, l'IBAN et une empreinte de l'ordre. Saisissez votre code PIN 3SKey dans le champ prévu à cet effet, puis cliquez sur Confirmer :
📖 Un journal d'audit est conservé pour chaque virement signé, comme preuve de votre ordre de virement. L'empreinte affichée à l'écran (par exemple 9zkzklep2meM) est une signature courte des paramètres du virement : elle garantit qu'aucun champ n'a été modifié entre le moment où vous avez préparé le virement et le moment où vous le signez.
❓ FAQ rapide
Combien coûte un contrat EBICS T ?
Les frais sont fixés par chaque banque. Comptez en général entre quelques dizaines et quelques centaines d'euros à la souscription, plus un abonnement mensuel modeste. Demandez la grille tarifaire à votre chargé d'affaires.
Puis-je connecter plusieurs banques en EBICS sur Fygr ?
Oui. Chaque banque fait l'objet d'un contrat EBICS distinct (Host ID, Partner ID et User ID propres à chacune), et chaque connexion est paramétrée séparément dans Fygr.
EBICS remplace-t-il la connexion DSP2 ?
EBICS et DSP2 peuvent coexister. Pour les comptes professionnels à fort volume ou nécessitant des relevés MT940 / CAMT.053, EBICS est préférable. Pour des comptes occasionnels ou de petits volumes, la DSP2 reste pertinente et plus rapide à mettre en place.
Que se passe-t-il si je perds ma clé 3SKey ?
Contactez immédiatement votre banque pour révoquer la clé compromise et en obtenir une nouvelle. La nouvelle clé devra être enregistrée auprès de Fygr en suivant à nouveau la procédure d'initialisation (lettre INI à re-signer).
📖 Maintenant que votre connexion EBICS est en place, consultez l'article Comment connecter une banque à Fygr ? pour découvrir les autres modes de connexion bancaire disponibles.