Integrasi Webhooks

Setiap sinkronisasi mengirim JSON bertanda tangan melalui POST ke endpoint HTTPS Anda: transaksi, saldo, kepemilikan dan transaksi jual beli dari 14 rb+ bank, diverifikasi dengan kunci rahasia penandatanganan Anda sendiri.

Hubungkan Webhooks Referensi webhook

Bank dan kartu

Chase Checking••1879
Amex Gold••9880

Transaksi

19 OktStripe payout+$4,200.00
19 OktWhole Foods Market−$86.42
18 OktGusto 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  ]}

Di setiap sinkronisasi

Endpoint Anda menjawab 200 dalam 142 ms. Respons lain dicoba ulang dengan backoff, dengan id yang sama.

Satu pengiriman transactions.delta dari Chase Checking dan Amex Gold, ditandatangani dengan kunci rahasia whsec_ Anda dalam format Standard Webhooks.

Dari bank ke server Anda dalam tiga langkah.

01
Hubungkan endpoint
Tempel URL HTTPS publik. BankSync menampilkan kunci rahasia penandatanganan whsec_ satu kali, lalu mengirim event uji.
URLhttps://api.yourapp.com/…
Kunci rahasiawhsec_••••••••••••
Event uji● 200 dalam 142ms
02
Arahkan feed ke endpoint
Pilih rekening dan jenis data. Tidak ada yang perlu dipetakan: Anda menerima amplop JSON berversi.
TransaksiSaldoKepemilikanJual beliPinjaman
Eventtransactions.delta
PemetaanTidak ada, pratinjau payload

Verifikasi setiap pengiriman

Periksa tanda tangan dengan library Standard Webhooks mana pun, lalu lakukan upsert baris berdasarkan id.

server.js

import { Webhook } from 'standardwebhooks'const wh = new Webhook(secret)const event = wh.verify(body, headers)// deduplikasi berdasarkan event.id

Siapkan Webhooks, dari awal sampai akhir.

Menyiapkan Webhooks di BankSync, direkam dengan rekening contoh.

Apa yang tiba di endpoint Anda.

id: Unik per pengiriman dan tetap sama di setiap percobaan ulang. Kunci idempotensi Anda, sama dengan header webhook-id.
type: transactions.delta untuk transaksi baru atau yang berubah; saldo, kepemilikan, transaksi jual beli, order dan pinjaman tiba sebagai *.snapshot.
apiVersion: Kontrak payload yang dipatok ke tanggal, saat ini 2026-06-01.
feed: Id, nama dan jenis data dari feed yang mengirimnya.
job: Proses tempatnya berada, dan apa yang memulainya: scheduled, manual, api, test atau redelivery.
batch: Posisi batch dalam proses, agar Anda dapat mengurutkannya.
data: Baris data. Transaksi berisi id, tanggal, deskripsi, jumlah bertanda, mata uang, kategori, status tertunda dan rekening.

Tabel field untuk setiap jenis data dan kode verifikasi dalam beberapa bahasa tersedia di referensi webhook.

Endpoint Anda hanyalah satu perhentian. Bukan keseluruhan cerita.

BankSync

Spreadsheet

Ruang kerja

AI pilihan Anda

Kode Anda

Webhooks, secara singkat.

Data: Transaksi, saldo, kepemilikan, transaksi jual beli, order dan pinjaman, satu jenis data per feed.
Penandatanganan: Standard Webhooks: HMAC-SHA256 atas id, timestamp dan body. Saat kunci rahasia dirotasi, kunci lama tetap berlaku selama 24 jam.
Pengiriman: Setidaknya sekali. 408, 425, 429, 5xx dan timeout dicoba ulang dengan backoff; 410 menonaktifkan endpoint.
Endpoint: Hanya HTTPS publik. Alamat privat, loopback dan internal ditolak.
Jadwal: Pilih sinkronisasi otomatis per jam, harian atau mingguan sesuai paket Anda, atau jalankan sinkronisasi manual kapan saja.
Paket: Paket Standard atau lebih tinggi, bersama API dan MCP.
Penyiapan: Sekitar 5 menit. Kirim JSON bertanda tangan ke endpoint Anda sendiri; tanpa biaya pihak ketiga.
Status: Tersedia sekarang.
Hubungkan dari: Chase Bank of America Wells Fargo Capital One TD Bank Regions Bank Lihat semua bank
Terkait: Actual Budget Airtable Firefly III Google Sheets Home Assistant Microsoft Excel Lihat semua integrasi

Pertanyaan, terjawab.

Bagaimana cara memverifikasi webhook BankSync?

Setiap pengiriman membawa header webhook-id, webhook-timestamp dan webhook-signature dalam format Standard Webhooks. Verifikasi header tersebut dengan kunci rahasia whsec_ Anda menggunakan library Standard Webhooks mana pun, dan tolak timestamp yang berusia lebih dari 5 menit.

Apa yang terjadi jika endpoint saya sedang mati?

Pengiriman dilakukan setidaknya sekali. Respons 408, 425, 429, 5xx dan timeout dicoba ulang dengan exponential backoff dengan id yang sama, jadi lakukan deduplikasi berdasarkan id. Respons 410 menonaktifkan endpoint.

Event apa saja yang dikirim BankSync?

transactions.delta untuk transaksi baru atau yang berubah; balances.snapshot, holdings.snapshot, trades.snapshot, orders.snapshot dan loans.snapshot untuk kondisi terkini; sync.completed atau sync.failed di akhir setiap proses; dan endpoint.test untuk event uji.

Bisakah saya mengirim webhook ke localhost atau jaringan privat?

Tidak. Endpoint harus berupa URL https:// publik. Alamat yang mengarah ke rentang privat, loopback, link-local atau internal ditolak saat Anda menyimpannya.

Paket mana yang mencakup webhook?

Webhook adalah bagian dari fitur pengembang di paket Standard ke atas, bersama API dan MCP.

Data bank di endpoint Anda.

Coba gratis Lihat harga

BankSync tidak berafiliasi dengan, tidak didukung oleh dan bukan mitra resmi Webhooks. Merek dagang Webhooks adalah milik pemiliknya masing-masing.