Utilisez ce guide étape par étape pour connecter l'accord EBICS SEPA Direct Debit dans Frisbii. Configurez à la fois un accord réel (connecté à votre banque) et un accord de test (utilisé pour la simulation et le développement).
Mise en place d'un accord EBICS réel
Cette option connecte le Frisbii Checkout directement au compte bancaire professionnel via EBICS. La banque doit créer un utilisateur EBICS, lui attribuer les permissions adéquates et vous fournir les informations d'identification nécessaires avant que vous ne puissiez procéder à l'installation.
🏦 Important : Contactez votre banque pour demander la création d'un utilisateur EBICS pour le prélèvement SEPA.
Dans ce guide, vous trouverez une liste des détails spécifiques et des types de commandes que votre banque doit configurer. Vous ne pourrez pas terminer la configuration tant que cet utilisateur n'aura pas été créé et approuvé.
Types de commandes et autorisations EBICS nécessaires
L'utilisateur EBICS doit disposer des types de commande appropriés pour permettre à Frisbii d'envoyer des prélèvements SEPA, de procéder à des remboursements et de consulter l'état des transactions.
Assurez-vous que votre banque offre au moins les possibilités suivantes :
CDD - Direct Debit (pour l'encaissement des paiements SEPA)
CCT - Credit Transfer (utilisé pour les remboursements SEPA)
CDZ - Rapport sur l'état des prélèvements automatiques (format ZIP)
CRZ - Rapport sur l'état des transferts de crédits (format ZIP)
HAC - Aperçu de l'état du dossier
C53 - Fichier de relevé de compte (format CAMT.053, utilisé pour le rapprochement)
HIA - Initialisation de la clé publique
INI - Enregistrement initial
⚠️ Si ces autorisations sont manquantes, Frisbii ne sera pas en mesure de télécharger des fichiers de paiement, de recevoir des réponses ou de rapprocher les transactions correctement.
Demandez à votre banque de confirmer que l'utilisateur a obtenu ces droits avant de poursuivre l'installation dans Frisbii.
Étape 1 : Accéder à la zone de configuration
Commencez par vous rendre dans la section appropriée de Frisbii Admin :
Cliquez sur Configuration dans le menu de gauche.
Allez dans la section Checkout management.
Cliquez sur Méthodes de paiement.
Faites défiler vers le bas jusqu'à Débit bancaires et virements.
Etape 2 : Sélectionner EBICS comme processeur SEPA
Choisissez SEPA Direct Debit (EBICS) dans la liste des processeurs disponibles.
Cette option vous permet d'exercer un contrôle total en utilisant votre propre compte bancaire et votre connexion EBICS.
Étape 3 : Cliquez sur "Utiliser l'accord existant"
Cliquez sur Utiliser l'accord existant pour commencer la configuration.
Important : Votre banque doit d'abord créer un utilisateur EBICS pour votre entreprise. Il s'agit notamment de générer des informations d'identification telles que l'ID de l'utilisateur, l'identifiant du client et l'ID de l'hôte. Vous ne pourrez pas terminer l'installation en direct sans ces éléments.
Étape 4 : Remplir les données de l'utilisateur EBICS
Saisissez les informations d'identification fournies par votre banque :
ID de l'utilisateur - identifiant de l'utilisateur EBICS émis
Identifiant du client - l'identifiant de votre entreprise dans EBICS
ID de l'hôte - l'ID hôte EBICS de votre banque
URL - URL du point d'accès au serveur EBICS de votre banque
Ces valeurs authentifient votre configuration et permettent une communication sécurisée avec votre banque.
Étape 5 : Saisir les coordonnées de l'entreprise et de la banque
Ajoutez maintenant vos informations de paiement et d'identité :
Nom de l'entreprise - nom de l'entité légale
Nom de la banque - nom de votre banque
Entreprise IBAN - le compte qui reçoit les fonds SEPA
Code d'identification de la banque (BIC) - le code SWIFT/BIC de votre banque
Identifiant du créancier - votre identifiant officiel de créancier SEPA
Champ d'application - sélectionnez les pays dans lesquels vous souhaitez accepter les paiements par prélèvement SEPA.
Étape 6 : Ajuster les paramètres optionnels
Réservation de lots SEPA
Activez cette option pour regrouper les paiements SEPA en une seule ligne récapitulative (sum-tal) sur votre relevé bancaire.
Désactiver si vous souhaitez que chaque débit individuel soit listé séparément.
Secure SEPA : Des frais s'appliquent
L'activation de Secure SEPA ajoute 0,10 € par transaction, facturé par Frisbii. Il renforce la sécurité en exigeant du client qu'il confirme l'IBAN par le biais de sa connexion bancaire en ligne.
Cliquez sur Activer pour accepter cette redevance.
Étape 7 : Soumettre le formulaire et envoyer le fichier d'initiation
Cliquez sur le bouton vert Créer pour enregistrer votre configuration.
Frisbii génère alors un fichier d'initiation PDF qui doit être envoyé à votre banque pour activer l'utilisateur EBICS.
📄 Qu'est-ce que ce fichier ?
Il contient les empreintes cryptographiques et les métadonnées d'enregistrement dont votre banque a besoin pour finaliser la connexion.
.png)
Étape 8 : Attendre la confirmation de la banque et terminer la configuration
Votre configuration EBICS restera inactive jusqu'à ce que votre banque traite et approuve le fichier d'initiation.
Une fois confirmés, les paiements SEPA commenceront à transiter par la connexion.
Étape 8 : Attendre la confirmation de la banque
Une fois que votre banque a traité et approuvé le fichier d'initiation, retournez sur Frisbii et cliquez sur le bouton Compléter de l'accord pour finaliser l'installation.
✅ L'installation réelle est terminée !
Votre accord apparaît désormais dans Frisbii sous la rubrique Accords de prélèvement SEPA. Vous pouvez revenir ici à tout moment pour effectuer des mises à jour.
.png)
Mise en place d'un accord EBICS de test
Cette version simule le prélèvement SEPA dans un environnement de non-production. Vous n'avez pas besoin d'impliquer votre banque.
Étape 1 : Accéder à la zone de configuration
Cliquez sur Configuration dans le menu de gauche.
Allez dans la section Checkout management.
Cliquez sur Méthodes de paiement.
Faites défiler jusqu'à Débit bancaires et virements.
Etape 2 : Sélectionner EBICS comme processeur SEPA
Cliquez sur SEPA Direct Debit (EBICS).
Cette fois, vous allez saisir des informations d'identification fictives à des fins de test.
Étape 3 : Cliquez sur "Utiliser l'accord existant"
Cliquez sur Utiliser l'accord existant pour ouvrir le formulaire de configuration.
Étape 4 : Saisir des identifiants de test fictifs
Vous pouvez utiliser des valeurs fictives dans tous les champs obligatoires :
ID de l'utilisateur :
testuser123Identifiant du client :
testcustomer456ID de l'hôte :
testhost789URL
: https://ebics-test.example.comNom de l'entreprise :
Société de testNom de la banque:
Banque de testEntreprise IBAN :
DE44500105175407324931Code d'identification de la banque (BIC) :
TESTDEFFXXXIdentifiant du créancier :
DE98ZZZ09999999999Champ d'application : Choisir n'importe quelle liste de pays (par exemple, DE, FR, NL)
Étape 5 : Paramètres supplémentaires
Réservation de lots SEPA
Vous pouvez toujours activer la comptabilisation par lots en mode test pour simuler la façon dont les entrées groupées ou individuelles apparaîtront dans les fichiers de sortie de la banque.
Étape 6 : Sauvegarder votre accord de test et terminer la configuration
Cliquez sur Créer pour enregistrer votre configuration de test et générer l'accord.
Frisbii ne génère pas de fichier d'initiation et aucun contact avec votre banque n'est nécessaire.
La dernière étape consiste à cliquer sur le bouton Terminer qui apparaît juste après pour finaliser la configuration du test.
✅ Configuration du test terminée !
Vous pouvez désormais simuler des flux de prélèvement SEPA dans Frisbii sans envoyer d'argent réel ni avoir besoin de l'approbation de la banque.
Effectuez des paiements par prélèvement SEPA sur votre compte test
Une fois que votre accord de test est actif, vous pouvez commencer à envoyer des paiements par prélèvement SEPA simulés.
Comportement par défaut
Par défaut, le simulateur accepte tous les IBAN qui passent la validation de base. Nous utilisons Apache Commons pour la validation du format, de sorte que les IBAN non valides (par exemple, longueur incorrecte ou caractères illégaux) seront rejetés.
IBANs de test spéciaux pour les scénarios d'échec
Vous pouvez utiliser les IBAN suivants pour simuler différentes conditions de défaillance :
DE45500105177371331928
Toutes les transactions de paiement seront rejetées.DE07500105173815895291
Les paiements seront acceptés, mais tout remboursement vers cet IBAN sera rejeté.DE33500105178723347632
Les paiements seront acceptés, mais ils entraîneront immédiatement une rétrofacturation.
Frisbii renvoie un état de transaction HARD_DECLINED pour tous les paiements rejetés.
Actuellement, SOFT_DECLINED n'est pas utilisé pour SEPA EBICS.