Webhooks-integration
Vid varje synk skickas signerad JSON med POST till din HTTPS-slutpunkt: transaktioner, saldon, innehav och affärer från 14 tn+ banker, verifierad med din egen signeringsnyckel.
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 ]}
Från banken till din server i tre steg.
- 01
Anslut en slutpunkt
Klistra in en publik HTTPS-URL. BankSync visar en whsec_-signeringsnyckel en gång och skickar en testhändelse.
URLhttps://api.yourapp.com/…Hemlig nyckelwhsec_••••••••••••Testhändelse● 200 på 142 ms - 02
Koppla ett flöde till den
Välj konton och en datatyp. Inget behöver mappas: du får ett versionerat JSON-kuvert.
TransaktionerSaldonInnehavAffärerLånHändelsetransactions.deltaMappningIngen, förhandsvisning av payload - 03
Verifiera varje leverans
Kontrollera signaturen med valfritt Standard Webhooks-bibliotek och gör sedan upsert av raderna på id.
server.js
import { Webhook } from 'standardwebhooks'const wh = new Webhook(secret)const event = wh.verify(body, headers)// deduplicera på event.id
Konfigurera Webhooks från början till slut.
Så konfigureras Webhooks i BankSync, filmat med exempelkonton.
Det här når din slutpunkt.
- id
- Unikt per leverans och oförändrat mellan nya försök. Din idempotensnyckel, samma som headern webhook-id.
- type
- transactions.delta för nya eller ändrade transaktioner; saldon, innehav, affärer, order och lån kommer som *.snapshot.
- apiVersion
- Payload-kontraktet, låst till ett datum, för närvarande 2026-06-01.
- feed
- Id, namn och datatyp för flödet som skickade den.
- job
- Körningen den hör till och vad som startade den: scheduled, manual, api, test eller redelivery.
- batch
- Batchens plats i körningen, så att du kan sortera dem.
- data
- Raderna. Transaktioner innehåller id, datum, beskrivning, belopp med förtecken, valuta, kategori, pending-flagga och kontot.
Din slutpunkt är en anhalt. Inte hela resan.
Webhooks i korthet.
- Data
- Transaktioner, saldon, innehav, affärer, order och lån, en datatyp per flöde.
- Signering
- Standard Webhooks: HMAC-SHA256 över id, tidsstämpel och body. När du roterar nyckeln gäller den gamla i 24 timmar till.
- Leverans
- Leverans minst en gång. Vid 408, 425, 429, 5xx och timeout görs nya försök med backoff; 410 inaktiverar slutpunkten.
- Slutpunkter
- Endast publika HTTPS-adresser. Privata adresser, loopback-adresser och interna adresser avvisas.
- Schema
- Välj automatisk synk varje timme, dag eller vecka beroende på ditt abonnemang, eller kör en manuell synk när som helst.
- Abonnemang
- Standard-abonnemanget eller högre, tillsammans med API:et och MCP.
- Konfiguration
- Cirka 5 minuter. Skicka signerad JSON till din egen endpoint, utan kostnad hos tredje part.
- Status
- Tillgänglig i dag.
Frågor och svar.
Hur verifierar jag en webhook från BankSync?
Varje leverans har headrarna webhook-id, webhook-timestamp och webhook-signature i Standard Webhooks-formatet. Verifiera dem med din whsec_-nyckel och valfritt Standard Webhooks-bibliotek, och avvisa tidsstämplar som är äldre än 5 minuter.
Vad händer om min slutpunkt ligger nere?
Leveransen sker minst en gång. Vid 408, 425, 429, 5xx och timeout görs nya försök med exponentiell backoff under samma id, så deduplicera på id. Ett 410-svar inaktiverar slutpunkten.
Vilka händelser skickar BankSync?
transactions.delta för nya eller ändrade transaktioner; balances.snapshot, holdings.snapshot, trades.snapshot, orders.snapshot och loans.snapshot för aktuellt läge; sync.completed eller sync.failed i slutet av varje körning; och endpoint.test för testhändelser.
Kan jag skicka webhooks till localhost eller ett privat nätverk?
Nej. Slutpunkter måste vara publika https://-adresser. Adresser som pekar på privata, loopback-, link-local- eller interna adressintervall avvisas när du sparar dem.
Vilket abonnemang innehåller webhooks?
Webhooks ingår från Standard-abonnemanget och uppåt, tillsammans med API:et och MCP.
Bankdata till din slutpunkt.
BankSync är inte anslutet till, godkänt av eller officiell partner till Webhooks. Varumärken som tillhör Webhooks ägs av respektive ägare.
