Webhooks-integratie
Elke sync stuurt met POST ondertekende JSON naar je HTTPS-endpoint: transacties, saldi, posities en trades van 14K+ banken, te verifiëren met je eigen ondertekeningsgeheim.
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 ]}
Van bank naar je server in drie stappen.
- 01
Koppel een endpoint
Plak een openbare HTTPS-URL. BankSync toont één keer een whsec_-ondertekeningsgeheim en stuurt een testgebeurtenis.
URLhttps://api.yourapp.com/…Geheimwhsec_••••••••••••Testgebeurtenis● 200 in 142 ms - 02
Richt een feed erop
Kies rekeningen en een gegevenstype. Er valt niets te koppelen: je krijgt een JSON-envelop met versienummer.
TransactiesSaldiPositiesTradesLeningenGebeurtenistransactions.deltaVeldmappingGeen, een payloadvoorbeeld - 03
Verifieer elke levering
Controleer de handtekening met een willekeurige Standard Webhooks-bibliotheek en upsert daarna rijen op id.
server.js
import { Webhook } from 'standardwebhooks'const wh = new Webhook(secret)const event = wh.verify(body, headers)// ontdubbelen op event.id
Webhooks instellen, van begin tot eind.
Webhooks instellen in BankSync, gefilmd met voorbeeldrekeningen.
Wat er op je endpoint binnenkomt.
- id
- Uniek per levering en gelijk bij elke nieuwe poging. Je idempotentiesleutel, gelijk aan de header webhook-id.
- type
- transactions.delta voor nieuwe of gewijzigde transacties; saldi, posities, trades, orders en leningen komen binnen als *.snapshot.
- apiVersion
- Het payloadcontract, vastgezet op datum, momenteel 2026-06-01.
- feed
- Het id, de naam en het gegevenstype van de feed die hem verstuurde.
- job
- De run waar hij bij hoort, en wat die startte: scheduled, manual, api, test of redelivery.
- batch
- De plaats van de batch in de run, zodat je ze kunt ordenen.
- data
- De rijen. Transacties bevatten id, datum, omschrijving, bedrag met teken, valuta, categorie, pending en de rekening.
Je endpoint is één halte. Niet het hele verhaal.
Webhooks, in het kort.
- Gegevens
- Transacties, saldi, posities, trades, orders en leningen, één gegevenstype per feed.
- Ondertekening
- Standard Webhooks: HMAC-SHA256 over het id, de tijdstempel en de body. Bij het roteren van het geheim blijft het oude nog 24 uur geldig.
- Levering
- Minstens één keer. 408, 425, 429, 5xx en time-outs worden met backoff opnieuw geprobeerd; 410 schakelt het endpoint uit.
- Endpoints
- Alleen openbare HTTPS. Privé-, loopback- en interne adressen worden geweigerd.
- Schema
- Kies afhankelijk van je abonnement voor automatische synchronisatie per uur, dag of week, of start op elk moment handmatig een synchronisatie.
- Abonnement
- Standard-abonnement of hoger, samen met de API en MCP.
- Installatie
- Ongeveer 5 minuten. Stuur ondertekende JSON naar je eigen endpoint; geen kosten bij derden.
- Status
- Nu beschikbaar.
Vragen, beantwoord.
Hoe verifieer ik een BankSync-webhook?
Elke levering bevat de headers webhook-id, webhook-timestamp en webhook-signature in het Standard Webhooks-formaat. Verifieer ze met je whsec_-geheim met een willekeurige Standard Webhooks-bibliotheek en weiger tijdstempels die ouder zijn dan 5 minuten.
Wat gebeurt er als mijn endpoint onbereikbaar is?
Levering gebeurt minstens één keer. Antwoorden 408, 425, 429 en 5xx en time-outs worden met exponentiële backoff opnieuw geprobeerd onder hetzelfde id, dus ontdubbel op id. Een antwoord 410 schakelt het endpoint uit.
Welke gebeurtenissen verstuurt BankSync?
transactions.delta voor nieuwe of gewijzigde transacties; balances.snapshot, holdings.snapshot, trades.snapshot, orders.snapshot en loans.snapshot voor de actuele stand; sync.completed of sync.failed aan het eind van elke run; en endpoint.test voor testgebeurtenissen.
Kan ik webhooks naar localhost of een privénetwerk sturen?
Nee. Endpoints moeten openbare https://-URL’s zijn. Adressen die naar privé-, loopback-, link-local- of interne bereiken verwijzen, worden geweigerd zodra je ze opslaat.
Welk abonnement bevat webhooks?
Webhooks horen bij de ontwikkelaarsfuncties van het Standard-abonnement en hoger, samen met de API en MCP.
Bankgegevens op je endpoint.
BankSync is niet gelieerd aan, onderschreven door of een officiële partner van Webhooks. Handelsmerken van Webhooks zijn eigendom van hun respectieve eigenaren.
