Webhooks-integration

Hver synkronisering sender signeret JSON med POST til dit HTTPS-endpoint: transaktioner, saldi, beholdninger og handler fra 14 t+ banker, verificeret med din egen signeringsnøgle.

Forbind Webhooks Webhook-reference

Banker og kort

Chase Checking••1879
Amex Gold••9880

Transaktioner

19. okt.Stripe payout+$4,200.00
19. okt.Whole Foods Market−$86.42
18. okt.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  ]}

Ved hver synkronisering

Dit endpoint svarede 200 på 142 ms. Alt andet forsøges igen med backoff under samme id.

Én transactions.delta-levering med transaktioner fra Chase Checking og Amex Gold, signeret med din whsec_-hemmelighed i Standard Webhooks-formatet.

Fra banken til din server i tre trin.

01
Forbind et endpoint
Indsæt en offentlig HTTPS-URL. BankSync viser en whsec_-signeringshemmelighed én gang og sender en testhændelse.
URLhttps://api.yourapp.com/…
Signeringsnøglewhsec_••••••••••••
Testhændelse● 200 på 142 ms
02
Peg et feed på det
Vælg konti og en datatype. Der er intet at mappe: du får en versioneret JSON-konvolut.
TransaktionerSaldiBeholdningerHandlerLån
Hændelsetransactions.delta
MappingIngen, en forhåndsvisning af payloaden

Verificer hver levering

Tjek signaturen med et vilkårligt Standard Webhooks-bibliotek, og lav derefter upsert af rækkerne på id.

server.js

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

Webhooks, sat op fra start til slut.

Opsætning af Webhooks i BankSync, optaget med eksempelkonti.

Det, der lander på dit endpoint.

id: Unik pr. levering og uændret ved genforsøg. Din idempotensnøgle, den samme som headeren webhook-id.
type: transactions.delta for nye eller ændrede transaktioner; saldi, beholdninger, handler, ordrer og lån kommer som *.snapshot.
apiVersion: Den datofastlåste aftale om payloadens format, i øjeblikket 2026-06-01.
feed: Id, navn og datatype for det feed, der sendte den.
job: Den kørsel, den hører til, og hvad der startede den: scheduled, manual, api, test eller redelivery.
batch: Batchens plads i kørslen, så du kan sortere dem.
data: Rækkerne. Transaktioner indeholder id, dato, beskrivelse, beløb med fortegn, valuta, kategori, ventende-status og kontoen.

Felttabeller for alle datatyper og verifikationskode i flere sprog finder du i webhook-referencen.

Dit endpoint er ét stop. Ikke hele historien.

BankSync

Regneark

Arbejdsområder

AI efter dit valg

Din kode

Webhooks, kort fortalt.

Data: Transaktioner, saldi, beholdninger, handler, ordrer og lån, én datatype pr. feed.
Signering: Standard Webhooks: HMAC-SHA256 over id, tidsstempel og body. Når du roterer nøglen, er den gamle stadig gyldig i 24 timer.
Levering: Mindst én gang. 408, 425, 429, 5xx og timeouts forsøges igen med backoff; 410 deaktiverer endpointet.
Endpoints: Kun offentlig HTTPS. Private, loopback- og interne adresser afvises.
Tidsplan: Vælg automatisk synkronisering hver time, dagligt eller ugentligt afhængigt af dit abonnement, eller kør en manuel synkronisering når som helst.
Abonnement: Standard-abonnement eller højere, sammen med API’et og MCP.
Opsætning: Cirka 5 minutter. Send signeret JSON til dit eget endpoint; ingen udgifter til tredjeparter.
Status: Tilgængelig nu.
Forbind fra: Chase Bank of America Wells Fargo Capital One TD Bank Regions Bank Se alle banker
Relateret: Actual Budget Airtable Firefly III Google Sheets Home Assistant Microsoft Excel Se alle integrationer

Spørgsmål og svar.

Hvordan verificerer jeg en webhook fra BankSync?

Hver levering har headerne webhook-id, webhook-timestamp og webhook-signature i Standard Webhooks-formatet. Verificer dem med din whsec_-nøgle via et vilkårligt Standard Webhooks-bibliotek, og afvis tidsstempler, der er mere end 5 minutter gamle.

Hvad sker der, hvis mit endpoint er nede?

Levering sker mindst én gang. Svar med 408, 425, 429, 5xx og timeouts forsøges igen med eksponentiel backoff under samme id, så fjern dubletter på id. Et 410-svar deaktiverer endpointet.

Hvilke hændelser sender BankSync?

transactions.delta for nye eller ændrede transaktioner; balances.snapshot, holdings.snapshot, trades.snapshot, orders.snapshot og loans.snapshot for den aktuelle tilstand; sync.completed eller sync.failed ved slutningen af hver kørsel; og endpoint.test for testhændelser.

Kan jeg sende webhooks til localhost eller et privat netværk?

Nej. Endpoints skal være offentlige https://-URL’er. Adresser, der peger på private, loopback-, link-local- eller interne områder, afvises, når du gemmer dem.

Hvilket abonnement indeholder webhooks?

Webhooks er en del af udviklerværktøjerne i Standard-abonnementet og op, sammen med API’et og MCP.

Bankdata på dit endpoint.

Prøv gratis Se priser

BankSync har ingen tilknytning til Webhooks og er hverken godkendt af eller officiel partner med Webhooks. Varemærkerne for Webhooks tilhører deres respektive ejere.