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.

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  ]}
En transactions.delta-leverans från Chase Checking och Amex Gold, signerad med din whsec_-nyckel i formatet Standard Webhooks.

Från banken till din server i tre steg.

  1. 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
  2. 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ån
    Händelsetransactions.delta
    MappningIngen, förhandsvisning av payload
  3. 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.
Fälttabeller för varje datatyp och verifieringskod på flera språk finns i webhook-referensen.

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.