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.
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 ]}
Von der Bank zu Ihrem Server in drei Schritten.
- 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 - 02
Feed darauf ausrichten
Wählen Sie Konten und einen Datentyp. Es gibt nichts zuzuordnen: Sie erhalten einen versionierten JSON-Umschlag.
TransaktionenKontoständePositionenTradesKrediteEreignistransactions.deltaZuordnungKeine, eine Payload-Vorschau - 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.
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.
