Webhooks – integraatio

Jokainen synkronointi lähettää POST-pyynnöllä allekirjoitettua JSON-dataa HTTPS-päätepisteeseesi: tilitapahtumat, saldot, omistukset ja kaupat 14 t.+ pankista, vahvistettuna omalla allekirjoitusavaimellasi.

Yhdistä Webhooks Webhook-dokumentaatio

Pankit ja kortit

Chase Checking••1879
Amex Gold••9880

Tapahtumat

19.10.Stripe payout+$4,200.00
19.10.Whole Foods Market−$86.42
18.10.Gusto payroll−$6,850.00

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  ]}

Jokaisella synkronoinnilla

Päätepisteesi vastasi 200, 142 ms. Muussa tapauksessa toimitusta yritetään uudelleen kasvavin viivein samalla tunnisteella.

Yksi transactions.delta-toimitus, jossa on tapahtumia tileiltä Chase Checking ja Amex Gold, allekirjoitettu whsec_-salaisuudellasi Standard Webhooks -muodossa.

Pankista palvelimellesi kolmessa vaiheessa.

01
Yhdistä päätepiste
Liitä julkinen HTTPS-URL. BankSync näyttää whsec_-allekirjoitussalaisuuden kerran ja lähettää testitapahtuman.
URLhttps://api.yourapp.com/…
Salainen avainwhsec_••••••••••••
Testitapahtuma● 200, 142 ms
02
Ohjaa syöte siihen
Valitse tilit ja tietotyyppi. Mitään ei tarvitse määrittää: saat versioidun JSON-kuoren.
TapahtumatSaldotOmistuksetKaupatLainat
Tapahtumatransactions.delta
KohdistusEi tarvita – sisällön esikatselu
03
Vahvista jokainen toimitus
Tarkista allekirjoitus millä tahansa Standard Webhooks -kirjastolla ja päivitä tai lisää rivit (upsert) id:n perusteella.
server.js
```
import { Webhook } from 'standardwebhooks'const wh = new Webhook(secret)const event = wh.verify(body, headers)// poista kaksoiskappaleet: event.id
```

Webhooks käyttöön alusta loppuun.

Käyttöönotto: Webhooks BankSync-palvelussa. Kuvattu esimerkkitileillä.

Mitä päätepisteeseesi saapuu.

id: Yksilöllinen jokaiselle toimitukselle ja sama kaikissa uudelleenyrityksissä. Tämä on idempotenssiavaimesi, sama kuin webhook-id-otsakkeessa.
type: transactions.delta uusille tai muuttuneille tilitapahtumille; saldot, omistukset, kaupat, toimeksiannot ja lainat saapuvat muodossa *.snapshot.
apiVersion: Päivämäärään sidottu sisältösopimus, tällä hetkellä 2026-06-01.
feed: Lähettäneen syötteen id, nimi ja tietotyyppi.
job: Ajo, johon toimitus kuuluu, ja mikä sen käynnisti: scheduled, manual, api, test tai redelivery.
batch: Erän paikka ajossa, jotta voit järjestää erät.
data: Rivit. Tilitapahtumissa on id, päivämäärä, kuvaus, etumerkillinen summa, valuutta, luokka, odottava-tila ja tili.

Kenttätaulukot jokaiselle tietotyypille ja vahvistuskoodi useilla ohjelmointikielillä löytyvät webhook-dokumentaatiosta.

Päätepisteesi on vain yksi kohde. Vaihtoehtoja on muitakin.

BankSync

Taulukot

Työtilat

Valitsemasi tekoäly

Oma koodisi

Webhooks lyhyesti.

Tiedot: Tapahtumat, saldot, omistukset, kaupat, toimeksiannot ja lainat, yksi tietotyyppi syötettä kohden.
Allekirjoitus: Standard Webhooks: HMAC-SHA256 id:stä, aikaleimasta ja rungosta. Kun vaihdat allekirjoitusavaimen, vanha pysyy voimassa 24 tuntia.
Toimitus: Vähintään kerran. Tilakoodit 408, 425, 429 ja 5xx sekä aikakatkaisut yritetään uudelleen kasvavalla viiveellä; 410 poistaa päätepisteen käytöstä.
Päätepisteet: Vain julkinen HTTPS. Yksityiset, loopback- ja sisäverkon osoitteet hylätään.
Aikataulu: Valitse pakettisi mukaan automaattinen synkronointi tunneittain, päivittäin tai viikoittain, tai käynnistä synkronointi käsin milloin tahansa.
Paketti: Standard-paketti tai ylempi, API:n ja MCP:n rinnalla.
Käyttöönotto: Noin 5 minuuttia. Lähetä allekirjoitettuja JSON-viestejä omaan päätepisteeseesi; ei kolmannen osapuolen kuluja.
Tila: Saatavilla nyt.
Yhdistä pankista: Chase Bank of America Wells Fargo Capital One TD Bank Regions Bank Katso kaikki pankit
Samankaltaiset: Actual Budget Airtable Firefly III Google Sheets Home Assistant Microsoft Excel Katso kaikki integraatiot

Kysymyksiä ja vastauksia.

Miten vahvistan BankSync-webhookin?

Jokaisessa toimituksessa on otsakkeet webhook-id, webhook-timestamp ja webhook-signature Standard Webhooks -muodossa. Vahvista ne whsec_-avaimellasi millä tahansa Standard Webhooks -kirjastolla ja hylkää yli 5 minuuttia vanhat aikaleimat.

Mitä tapahtuu, jos päätepisteeni ei vastaa?

Toimitus tapahtuu vähintään kerran. Vastaukset 408, 425, 429 ja 5xx sekä aikakatkaisut yritetään uudelleen eksponentiaalisesti kasvavalla viiveellä samalla id:llä, joten poista kaksoiskappaleet id:n perusteella. Vastaus 410 poistaa päätepisteen käytöstä.

Mitä tapahtumia BankSync lähettää?

transactions.delta uusille tai muuttuneille tilitapahtumille; balances.snapshot, holdings.snapshot, trades.snapshot, orders.snapshot ja loans.snapshot nykytilalle; sync.completed tai sync.failed jokaisen ajon lopussa; ja endpoint.test testitapahtumille.

Voinko lähettää webhookeja localhostiin tai yksityiseen verkkoon?

Ei. Päätepisteiden on oltava julkisia https://-osoitteita. Osoitteet, jotka osoittavat yksityisiin, loopback-, link-local- tai sisäverkon osoitealueisiin, hylätään tallennettaessa.

Mihin pakettiin webhookit sisältyvät?

Webhookit sisältyvät Standard-pakettiin ja sitä ylempiin yhdessä API:n ja MCP:n kanssa.

Pankkitiedot päätepisteeseesi.

Kokeile ilmaiseksi Katso hinnat

BankSync ei ole sidoksissa palveluun Webhooks, eikä Webhooks ole hyväksynyt BankSync-palvelua tai ole sen virallinen kumppani. Webhooks ja siihen liittyvät tavaramerkit kuuluvat omistajilleen.