Intégration Webhooks
Chaque synchronisation envoie par POST du JSON signé à votre endpoint HTTPS : transactions, soldes, positions et transactions sur titres de 14 k+ banques, vérifiés avec votre propre secret de signature.
webhook-id: evt_job-7q2_0_1_1webhook-timestamp: 1792501320webhook-signature: v1,K5oZfzN95Z9UVu1EsfQmfVNQhnkZ2pj9o9NDN/H/pI4=content-type: application/json { "id": "evt_job-7q2_0_1_1", "type": "transactions.delta", "apiVersion": "2026-06-01", "createdAt": "2026-10-20T13:02:00.000Z", "feed": { "id": "feed_9d1", "name": "Chase to Webhook", "dataType": "transactions" }, "job": { "id": "job_7q2", "trigger": "scheduled" }, "batch": { "sequence": 1 }, "data": [ { "id": "10a4d071832649a", "date": "2026-10-19", "amount": 4200.00, … }, { "id": "4bdd8e6931727cd", "date": "2026-10-19", "amount": -86.42, … }, …1 more ]}
De la banque à votre serveur en trois étapes.
- 01
Connecter un endpoint
Collez une URL HTTPS publique. BankSync affiche une seule fois un secret de signature whsec_ et envoie un événement de test.
URLhttps://api.yourapp.com/…Secretwhsec_••••••••••••Événement de test● 200 en 142 ms - 02
Y diriger un flux
Choisissez les comptes et un type de données. Rien à mapper : vous recevez une enveloppe JSON versionnée.
TransactionsSoldesPositionsAchats/ventesPrêtsÉvénementtransactions.deltaMappageAucun, un aperçu du payload - 03
Vérifier chaque livraison
Contrôlez la signature avec n’importe quelle bibliothèque Standard Webhooks, puis insérez ou mettez à jour les lignes par id.
server.js
import { Webhook } from 'standardwebhooks'const wh = new Webhook(secret)const event = wh.verify(body, headers)// dédoublonner sur event.id
Configurer Webhooks, du début à la fin.
Configuration de l’intégration Webhooks dans BankSync, filmée avec des comptes d’exemple.
Ce qui arrive sur votre endpoint.
- id
- Unique par livraison et stable d’une relance à l’autre. C’est votre clé d’idempotence, identique à l’en-tête webhook-id.
- type
- transactions.delta pour les transactions nouvelles ou modifiées ; soldes, positions, transactions sur titres, ordres et prêts arrivent en *.snapshot.
- apiVersion
- Le contrat de payload daté, actuellement 2026-06-01.
- feed
- L’id, le nom et le type de données du flux qui l’a envoyé.
- job
- L’exécution à laquelle il appartient, et ce qui l’a lancée : scheduled, manual, api, test ou redelivery.
- batch
- La place du lot dans l’exécution, pour que vous puissiez les ordonner.
- data
- Les lignes. Les transactions contiennent l’id, la date, le libellé, le montant signé, la devise, la catégorie, le statut en attente et le compte.
Votre endpoint n’est qu’une étape parmi d’autres.
Webhooks, en bref.
- Données
- Transactions, soldes, positions, transactions sur titres, ordres et prêts, un type de données par flux.
- Signature
- Standard Webhooks : HMAC-SHA256 sur l’id, l’horodatage et le corps. Après un renouvellement du secret, l’ancien reste valide pendant 24 heures.
- Livraison
- Au moins une fois. Après un code 408, 425, 429 ou 5xx, ou un délai dépassé, la livraison est retentée avec un délai croissant ; un code 410 désactive l’endpoint.
- Endpoints
- HTTPS public uniquement. Les adresses privées, de bouclage et internes sont refusées.
- Fréquence
- Choisissez une synchronisation automatique toutes les heures, chaque jour ou chaque semaine selon votre formule, ou lancez une synchronisation manuelle à tout moment.
- Formule
- Formule Standard ou supérieure, avec l’API et MCP.
- Configuration
- Environ 5 minutes. Envoi de JSON signé vers votre propre endpoint ; aucun coût tiers.
- Statut
- Disponible dès aujourd’hui.
Vos questions, nos réponses.
Comment vérifier un webhook BankSync ?
Chaque livraison contient les en-têtes webhook-id, webhook-timestamp et webhook-signature au format Standard Webhooks. Vérifiez-les avec votre secret whsec_ à l’aide de n’importe quelle bibliothèque Standard Webhooks, et rejetez les horodatages de plus de 5 minutes.
Que se passe-t-il si mon endpoint est indisponible ?
La livraison a lieu au moins une fois. Après une réponse 408, 425, 429 ou 5xx, ou un délai dépassé, la livraison est retentée avec un délai exponentiel, sous le même identifiant : dédoublonnez donc sur l’id. Une réponse 410 désactive l’endpoint.
Quels événements BankSync envoie-t-il ?
transactions.delta pour les transactions nouvelles ou modifiées ; balances.snapshot, holdings.snapshot, trades.snapshot, orders.snapshot et loans.snapshot pour l’état actuel ; sync.completed ou sync.failed à la fin de chaque exécution ; et endpoint.test pour les événements de test.
Puis-je envoyer des webhooks vers localhost ou un réseau privé ?
Non. Les endpoints doivent être des URL https:// publiques. Les adresses qui pointent vers des plages privées, de bouclage, link-local ou internes sont refusées à l’enregistrement.
Quelle formule inclut les webhooks ?
Les webhooks font partie des outils pour développeurs à partir de la formule Standard, avec l’API et MCP.
Vos données bancaires sur votre endpoint.
BankSync n’est ni affilié à Webhooks, ni approuvé par Webhooks, ni partenaire officiel de Webhooks. Les marques Webhooks appartiennent à leurs propriétaires respectifs.
