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.
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 ]}
Fra banken til serveren din i tre steg.
- 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 - 02
Pek en feed mot det
Velg kontoer og en datatype. Du trenger ikke tilordne noe: du får en versjonert JSON-konvolutt.
TransaksjonerSaldoerBeholdningerHandlerLånHendelsetransactions.deltaFelttilordningIngen, en forhåndsvisning av innholdet - 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.
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.
