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.

POST api.yourapp.com/webhooks/banksync200 OK · 142 ms
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  ]}
Une livraison transactions.delta depuis Chase Checking et Amex Gold, signée avec votre secret whsec_ au format Standard Webhooks.

De la banque à votre serveur en trois étapes.

  1. 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
  2. 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.delta
    MappageAucun, un aperçu du payload
  3. 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.
Les tables de champs de chaque type de données et le code de vérification en plusieurs langages se trouvent dans la référence des webhooks.

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.