Integration für Webhooks

Jede Synchronisierung sendet per POST signiertes JSON an Ihren HTTPS-Endpunkt: Transaktionen, Kontostände, Positionen und Trades aus 14.000+ Banken, verifiziert mit Ihrem eigenen Signatur-Secret.

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  ]}
Eine transactions.delta-Zustellung von Chase Checking und Amex Gold, signiert mit Ihrem whsec_-Secret im Format Standard Webhooks.

Von der Bank zu Ihrem Server in drei Schritten.

  1. 01

    Endpunkt verbinden

    Fügen Sie eine öffentliche HTTPS-URL ein. BankSync zeigt einmalig ein whsec_-Signatur-Secret an und sendet ein Testereignis.

    URLhttps://api.yourapp.com/…
    Secretwhsec_••••••••••••
    Testereignis● 200 in 142 ms
  2. 02

    Feed darauf ausrichten

    Wählen Sie Konten und einen Datentyp. Es gibt nichts zuzuordnen: Sie erhalten einen versionierten JSON-Umschlag.

    TransaktionenKontoständePositionenTradesKredite
    Ereignistransactions.delta
    ZuordnungKeine, eine Payload-Vorschau
  3. 03

    Jede Zustellung prüfen

    Prüfen Sie die Signatur mit einer beliebigen Standard-Webhooks-Bibliothek und schreiben Sie die Zeilen dann per Upsert über die ID.

    server.js

    import { Webhook } from 'standardwebhooks'const wh = new Webhook(secret)const event = wh.verify(body, headers)// Duplikate über event.id entfernen

Webhooks einrichten, von Anfang bis Ende.

Webhooks in BankSync einrichten, mit Beispielkonten gefilmt.

Was an Ihrem Endpunkt ankommt.

id
Eindeutig pro Zustellung und stabil über Wiederholungen hinweg. Ihr Idempotenzschlüssel, identisch mit dem Header webhook-id.
type
transactions.delta für neue oder geänderte Transaktionen; Kontostände, Positionen, Trades, Orders und Kredite kommen als *.snapshot.
apiVersion
Der datierte Payload-Vertrag, derzeit 2026-06-01.
feed
ID, Name und Datentyp des Feeds, der sie gesendet hat.
job
Der Lauf, zu dem sie gehört, und was ihn ausgelöst hat: scheduled, manual, api, test oder redelivery.
batch
Die Position des Batches im Lauf, damit Sie die Batches ordnen können.
data
Die Zeilen. Transaktionen enthalten ID, Datum, Beschreibung, Betrag mit Vorzeichen, Währung, Kategorie, Ausstehend-Status und das Konto.
Feldtabellen für jeden Datentyp und Verifizierungscode in mehreren Sprachen finden Sie in der Webhook-Referenz.

Ihr Endpunkt ist eine Station – nicht die ganze Strecke.

Webhooks, kurz gefasst.

Daten
Transaktionen, Kontostände, Positionen, Trades, Orders und Kredite, ein Datentyp pro Feed.
Signatur
Standard Webhooks: HMAC-SHA256 über ID, Zeitstempel und Body. Beim Rotieren des Secrets bleibt das alte 24 Stunden lang gültig.
Zustellung
Mindestens einmal. 408, 425, 429, 5xx und Timeouts werden mit Backoff wiederholt; 410 deaktiviert den Endpunkt.
Endpunkte
Nur öffentliches HTTPS. Private, Loopback- und interne Adressen werden abgelehnt.
Zeitplan
Wählen Sie je nach Tarif stündliche, tägliche oder wöchentliche automatische Synchronisierungen oder starten Sie jederzeit eine manuelle Synchronisierung.
Tarif
Tarif Standard oder höher, zusammen mit der API und MCP.
Einrichtung
Etwa 5 Minuten. Signiertes JSON an Ihren eigenen Endpunkt senden, ohne Kosten bei Drittanbietern.
Status
Ab sofort verfügbar.

Fragen und Antworten.

Wie verifiziere ich einen BankSync-Webhook?

Jede Zustellung trägt die Header webhook-id, webhook-timestamp und webhook-signature im Format Standard Webhooks. Prüfen Sie sie mit Ihrem whsec_-Secret und einer beliebigen Standard-Webhooks-Bibliothek, und lehnen Sie Zeitstempel ab, die älter als 5 Minuten sind.

Was passiert, wenn mein Endpunkt nicht erreichbar ist?

Die Zustellung erfolgt mindestens einmal. Antworten mit 408, 425, 429, 5xx sowie Timeouts werden mit exponentiellem Backoff unter derselben ID wiederholt, entfernen Sie Duplikate also über die ID. Eine 410-Antwort deaktiviert den Endpunkt.

Welche Ereignisse sendet BankSync?

transactions.delta für neue oder geänderte Transaktionen; balances.snapshot, holdings.snapshot, trades.snapshot, orders.snapshot und loans.snapshot für den aktuellen Stand; sync.completed oder sync.failed am Ende jedes Laufs; und endpoint.test für Testereignisse.

Kann ich Webhooks an localhost oder ein privates Netzwerk senden?

Nein. Endpunkte müssen öffentliche https://-URLs sein. Adressen, die in private, Loopback-, Link-Local- oder interne Bereiche auflösen, werden beim Speichern abgelehnt.

Welcher Tarif enthält Webhooks?

Webhooks gehören ab dem Tarif Standard zu den Entwicklerfunktionen, zusammen mit der API und MCP.

Bankdaten an Ihrem Endpunkt.

BankSync steht in keiner Verbindung zu Webhooks, wird von Webhooks weder empfohlen noch gefördert und ist kein offizieller Partner von Webhooks. Die Marken von Webhooks gehören ihren jeweiligen Inhabern.