Webhooks-integrasjon

Hver synkronisering sender signert JSON med POST til HTTPS-endepunktet ditt: transaksjoner, saldoer, beholdninger og handler fra 14k+ banker, verifisert med din egen signeringshemmelighet.

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  ]}
Én transactions.delta-levering fra Chase Checking og Amex Gold, signert med whsec_-hemmeligheten din i formatet Standard Webhooks.

Fra banken til serveren din i tre steg.

  1. 01

    Koble til et endepunkt

    Lim inn en offentlig HTTPS-URL. BankSync viser en whsec_-signeringshemmelighet én gang og sender en testhendelse.

    URLhttps://api.yourapp.com/…
    Hemmelighetwhsec_••••••••••••
    Testhendelse● 200 på 142 ms
  2. 02

    Pek en feed mot det

    Velg kontoer og en datatype. Du trenger ikke tilordne noe: du får en versjonert JSON-konvolutt.

    TransaksjonerSaldoerBeholdningerHandlerLån
    Hendelsetransactions.delta
    FelttilordningIngen, en forhåndsvisning av innholdet
  3. 03

    Verifiser hver levering

    Sjekk signaturen med et hvilket som helst Standard Webhooks-bibliotek, og oppdater eller sett inn rader etter id.

    server.js

    import { Webhook } from 'standardwebhooks'const wh = new Webhook(secret)const event = wh.verify(body, headers)// dedupliser på event.id

Webhooks, satt opp fra start til slutt.

Oppsett av Webhooks i BankSync, filmet med eksempelkontoer.

Dette kommer til endepunktet ditt.

id
Unik per levering og stabil på tvers av nye forsøk. Idempotensnøkkelen din, den samme som webhook-id-headeren.
type
transactions.delta for nye eller endrede transaksjoner; saldoer, beholdninger, handler, ordrer og lån kommer som *.snapshot.
apiVersion
Den datofestede kontrakten for innholdet, nå 2026-06-01.
feed
Id, navn og datatype for feeden som sendte den.
job
Kjøringen den tilhører, og hva som startet den: scheduled, manual, api, test eller redelivery.
batch
Hvor batchen hører hjemme i kjøringen, slik at du kan sortere dem.
data
Radene. Transaksjoner har id, dato, beskrivelse, beløp med fortegn, valuta, kategori, ventende-status og kontoen.
Felttabeller for alle datatyper og verifiseringskode i flere språk finner du i webhook-referansen.

Endepunktet ditt er ett stopp. Ikke hele historien.

Webhooks – kort fortalt.

Data
Transaksjoner, saldoer, beholdninger, handler, ordrer og lån, én datatype per kobling.
Signering
Standard Webhooks: HMAC-SHA256 over id, tidsstempel og innhold. Når du roterer hemmeligheten, er den gamle gyldig i 24 timer til.
Levering
Minst én gang. 408, 425, 429, 5xx og tidsavbrudd prøves på nytt med økende ventetid; 410 deaktiverer endepunktet.
Endepunkter
Bare offentlig HTTPS. Private, interne og loopback-adresser avvises.
Tidsplan
Velg automatisk synkronisering hver time, hver dag eller hver uke, avhengig av abonnementet ditt, eller kjør en manuell synkronisering når som helst.
Abonnement
Standard-abonnement eller høyere, sammen med API-et og MCP.
Oppsett
Omtrent 5 minutter. Send signert JSON til ditt eget endepunkt; ingen kostnader til tredjeparter.
Status
Tilgjengelig nå.

Spørsmål og svar.

Hvordan verifiserer jeg en webhook fra BankSync?

Hver levering har headerne webhook-id, webhook-timestamp og webhook-signature i Standard Webhooks-formatet. Verifiser dem med whsec_-hemmeligheten din i et hvilket som helst Standard Webhooks-bibliotek, og avvis tidsstempler som er eldre enn 5 minutter.

Hva skjer hvis endepunktet mitt er nede?

Levering skjer minst én gang. Svarene 408, 425, 429 og 5xx og tidsavbrudd prøves på nytt med eksponentielt økende ventetid under samme id, så fjern duplikater på id. Et 410-svar deaktiverer endepunktet.

Hvilke hendelser sender BankSync?

transactions.delta for nye eller endrede transaksjoner; balances.snapshot, holdings.snapshot, trades.snapshot, orders.snapshot og loans.snapshot for gjeldende tilstand; sync.completed eller sync.failed når hver kjøring er ferdig; og endpoint.test for testhendelser.

Kan jeg sende webhooker til localhost eller et privat nettverk?

Nei. Endepunkter må være offentlige https://-URL-er. Adresser som peker til private, interne, loopback- eller link-local-områder avvises når du lagrer dem.

Hvilket abonnement har webhooker?

Webhooker hører til utviklerverktøyene i Standard-abonnementet og høyere, sammen med API-et og MCP.

Bankdata på endepunktet ditt.

BankSync er ikke tilknyttet, godkjent av eller offisiell partner med Webhooks. Varemerkene til Webhooks tilhører de respektive eierne.