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.

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  ]}
Eén transactions.delta-levering van Chase Checking en Amex Gold, ondertekend met je whsec_-geheim in het Standard Webhooks-formaat.

Van bank naar je server in drie stappen.

  1. 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
  2. 02

    Richt een feed erop

    Kies rekeningen en een gegevenstype. Er valt niets te koppelen: je krijgt een JSON-envelop met versienummer.

    TransactiesSaldiPositiesTradesLeningen
    Gebeurtenistransactions.delta
    VeldmappingGeen, een payloadvoorbeeld
  3. 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.
Veldtabellen voor elk gegevenstype en verificatiecode in meerdere talen staan in de webhookreferentie.

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.