Services & Webhooks externes
Services & Webhooks externes
Points d’entrée pour connecter Bankin, Stripe, Prestashop, Pennylane et autres services.
Recevez les événements tiers et synchronisez automatiquement l’état dans votre application : paiements, rapprochements bancaires, imports et callbacks OAuth.
Capacités clés
Recevoir webhooks Bankin
Permet de recevoir les notifications Bankin (nouvelle transaction, mise à jour, erreurs de synchronisation) pour tenir vos écritures et rapprochements à jour.
Recevoir webhooks Stripe
Gère les événements Stripe (paiements, factures, remboursements, litiges) pour créer ou mettre à jour factures, transactions et paiements dans l’application.
Routes OAuth (Pennylane)
Flux de connexion OAuth pour Pennylane : l’utilisateur accepte l’accès côté fournisseur et revient vers l’application pour finaliser la liaison.
Routage spécifique Prestashop
Point d’entrée dédié pour synchroniser commandes, produits ou stocks depuis Prestashop vers l’application.
Configuration centralisée des webhooks
Interface pour copier l’URL fournie, choisir quels événements déclenchent les notifications et activer/désactiver l’envoi.
Historique et diagnostics
Journal des événements reçus avec payload, statut HTTP et message d’erreur pour dépanner et vérifier les traitements.
Sécurité et robustesse
Recommandations pour vérifier la source des webhooks et garantir que chaque événement est traité une seule fois (idempotence).
Tests et outils de copie
Outils intégrés pour voir le payload reçu, le copier dans le presse‑papier et rejouer ou analyser les erreurs.
Actions côté application
Les webhooks peuvent déclencher synchronisations, créations/mises à jour de données et enregistrer des logs d’événement.
How to use it
Configurer et utiliser les webhooks externes
Étape 1 — Obtenir l’URL webhook depuis l’application
Où : ouvrez Paramètres > Intégrations (ou Services & Webhooks).
Que faire : copiez l’URL de webhook affichée (champ “Webhook URL” ou similaire).
Résultat : vous avez l’adresse à communiquer au service tiers (Stripe, Bankin, Prestashop, …).
Étape 2 — Configurer le service tiers (ex. Stripe / Bankin / Prestashop)
Que faire : dans l’interface du service tiers, collez l’URL copiée dans la section Webhooks ou Notifications.
À remplir : sélectionnez les événements à envoyer (paiements réussis, invoice.finalized, transaction.updated, etc.). Si possible, ajoutez un secret/signature fourni par le tiers.
Résultat : le service tiers enverra désormais ses événements à votre application.
Étape 3 — Activer et sauvegarder les événements côté application
Que faire : dans Paramètres > Intégrations > Webhooks, choisissez quels types d’événements vous souhaitez recevoir (ex. paiements, remboursements, synchronisations). Cochez/décochez et sauvegardez.
À noter : la page affiche aussi l’historique des événements reçus et des erreurs.
Étape 4 — Tester un webhook (envoyer un événement de test)
Que faire : utilisez la fonction “envoyer un test” du service tiers (ou un outil de test) pour envoyer un payload de test.
Ce que vous voyez : l’événement apparaît dans la liste des événements reçus ; ouvrez‑le pour voir le payload formaté et le statut HTTP. Vous pouvez copier le payload ou le message d’erreur pour diagnostic.
Étape 5 — Gérer le callback OAuth (Pennylane)
Que faire : depuis Paramètres > Intégrations, cliquez sur “Connecter Pennylane” (ou le bouton d’activation). Vous serez redirigé vers Pennylane pour autoriser l’accès.
Après acceptation : le fournisseur redirige vers l’application ; la page vous renverra vers la section Comptabilité / Export ou la page de confirmation. Vérifiez que l’état “connecté” s’affiche dans les intégrations.
Étape 6 — Configurer la synchronisation Prestashop
Que faire : dans le module Prestashop, renseignez l’URL de synchronisation fournie par l’application (identique au webhook ou dédiée selon l’intégration). Activez les types de données à synchroniser (commandes, produits, stocks).
Résultat : Prestashop enverra des notifications de changements ; l’application synchronisera les éléments selon la configuration.
Étape 7 — Vérifier l’historique et corriger les erreurs
Que faire : ouvrez la liste des événements reçus dans Paramètres > Intégrations > Webhooks. Triez par date ou statut et inspectez : payload, réponse du service externe, message d’erreur.
Action possible : copier le payload pour tests locaux, corriger la configuration et relancer un test.
Étape 8 — Bonnes pratiques d’exploitation
Que faire : 1) testez d’abord sur une instance de staging ; 2) n’activez que les événements nécessaires ; 3) surveillez les statuts (200 OK vs 4xx/5xx).
Résultat : moins de bruit, traitement plus fiable et diagnostics plus simples.
Astuce pro
Avant de brancher un service en production, effectuez les tests sur un environnement de staging. Activez d’abord uniquement les événements essentiels (ex. paiement réussi) puis élargissez progressivement. Conservez une copie des payloads d’erreur pour faciliter le support.
Règles importantes et limites
- Vérifiez toujours la source des webhooks (signature ou secret côté fournisseur) avant d’appliquer des modifications en base : cela évite les envois frauduleux.
- Assurez l’idempotence : chaque événement tiers peut être envoyé plusieurs fois ; votre traitement doit détecter et ignorer les doublons pour éviter les écritures en double.
- Les callbacks OAuth gèrent un paramètre d’état et un code de retour : si l’état ne correspond pas, la liaison sera refusée.
- Les traitements déclenchés par webhooks peuvent provoquer des actions sur vos données (création, modification, synchronisation). Préparez des sauvegardes ou tests avant d’autoriser la production.
FAQ
Frequently Asked Questions
Besoin d’aide pour configurer une intégration ?
Si vous préférez, notre support peut vous accompagner pour configurer Stripe, Bankin, Prestashop ou Pennylane étape par étape.