Webhooks इंटीग्रेशन
हर सिंक आपके HTTPS एंडपॉइंट पर साइन किया हुआ JSON POST करता है: 14 हज़ार+ बैंकों से लेन-देन, बैलेंस, होल्डिंग्स और ट्रेड, जिन्हें आपके अपने साइनिंग सीक्रेट से सत्यापित किया जाता है।
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 ]}
बैंक से आपके सर्वर तक तीन चरणों में।
- 01
एंडपॉइंट कनेक्ट करें
एक सार्वजनिक HTTPS URL पेस्ट करें। BankSync एक whsec_ साइनिंग सीक्रेट एक बार दिखाता है और एक टेस्ट इवेंट भेजता है।
URLhttps://api.yourapp.com/…सीक्रेटwhsec_••••••••••••टेस्ट इवेंट● 142ms में 200 - 02
एक फ़ीड को इससे जोड़ें
खाते और एक डेटा प्रकार चुनें। मैप करने को कुछ नहीं है: आपको वर्ज़न वाला एक JSON एनवेलप मिलता है।
लेन-देनबैलेंसहोल्डिंग्सट्रेडलोनइवेंटtransactions.deltaमैपिंगकोई नहीं, सिर्फ़ पेलोड प्रीव्यू - 03
हर डिलीवरी सत्यापित करें
किसी भी Standard Webhooks लाइब्रेरी से सिग्नेचर जाँचें, फिर id के आधार पर पंक्तियाँ अपसर्ट करें।
server.js
import { Webhook } from 'standardwebhooks'const wh = new Webhook(secret)const event = wh.verify(body, headers)// event.id के आधार पर डी-डुप्लिकेट करें
Webhooks का सेटअप, शुरू से आख़िर तक।
BankSync में Webhooks का सेटअप, सैंपल खातों के साथ फ़िल्माया गया।
आपके एंडपॉइंट पर क्या पहुँचता है।
- id
- हर डिलीवरी के लिए अद्वितीय और दोबारा कोशिशों में एक जैसा। यही आपकी आइडेम्पोटेंसी कुंजी है, webhook-id हेडर के समान।
- type
- नए या बदले हुए लेन-देन के लिए transactions.delta; बैलेंस, होल्डिंग्स, ट्रेड, ऑर्डर और लोन *.snapshot के रूप में आते हैं।
- apiVersion
- तारीख से तय पेलोड अनुबंध, फ़िलहाल 2026-06-01।
- feed
- जिस फ़ीड ने इसे भेजा, उसका id, नाम और डेटा प्रकार।
- job
- वह रन जिसका यह हिस्सा है, और उसे किसने शुरू किया: scheduled, manual, api, test या redelivery।
- batch
- रन में बैच का क्रम, ताकि आप उन्हें क्रम से लगा सकें।
- data
- पंक्तियाँ। लेन-देन में id, तारीख, विवरण, +/− चिह्न वाली राशि, मुद्रा, श्रेणी, लंबित स्थिति और खाता होते हैं।
आपका एंडपॉइंट एक पड़ाव है। पूरी कहानी नहीं।
Webhooks, संक्षेप में।
- डेटा
- लेन-देन, बैलेंस, होल्डिंग्स, ट्रेड, ऑर्डर और लोन, हर फ़ीड में एक डेटा प्रकार।
- साइनिंग
- Standard Webhooks: id, टाइमस्टैम्प और बॉडी पर HMAC-SHA256। सीक्रेट रोटेट करने पर पुराना सीक्रेट 24 घंटे तक मान्य रहता है।
- डिलीवरी
- कम से कम एक बार। 408, 425, 429, 5xx और टाइमआउट पर बैकऑफ़ के साथ दोबारा कोशिश होती है; 410 एंडपॉइंट को बंद कर देता है।
- एंडपॉइंट
- केवल सार्वजनिक HTTPS। प्राइवेट, लूपबैक और आंतरिक पते अस्वीकार किए जाते हैं।
- शेड्यूल
- अपने प्लान के अनुसार हर घंटे, रोज़ाना या साप्ताहिक ऑटोमैटिक सिंक चुनें, या कभी भी मैन्युअल सिंक चलाएँ।
- प्लान
- Standard प्लान या उससे ऊपर, API और MCP के साथ।
- सेटअप
- लगभग 5 मिनट। अपने एंडपॉइंट पर साइन किया गया JSON भेजें; किसी तीसरे पक्ष का खर्च नहीं।
- स्थिति
- अभी उपलब्ध।
सवाल, जवाब के साथ।
मैं BankSync वेबहुक को कैसे सत्यापित करूँ?
हर डिलीवरी में Standard Webhooks फ़ॉर्मैट में webhook-id, webhook-timestamp और webhook-signature हेडर होते हैं। किसी भी Standard Webhooks लाइब्रेरी से अपने whsec_ सीक्रेट का उपयोग करके इन्हें सत्यापित करें, और 5 मिनट से पुराने टाइमस्टैम्प अस्वीकार करें।
अगर मेरा एंडपॉइंट डाउन हो, तो क्या होगा?
डिलीवरी कम से कम एक बार होती है। 408, 425, 429, 5xx रिस्पॉन्स और टाइमआउट पर उसी id के साथ एक्सपोनेंशियल बैकऑफ़ से दोबारा कोशिश होती है, इसलिए id के आधार पर डी-डुप्लिकेट करें। 410 रिस्पॉन्स एंडपॉइंट को बंद कर देता है।
BankSync कौन-से इवेंट भेजता है?
नए या बदले हुए लेन-देन के लिए transactions.delta; मौजूदा स्थिति के लिए balances.snapshot, holdings.snapshot, trades.snapshot, orders.snapshot और loans.snapshot; हर रन के अंत में sync.completed या sync.failed; और टेस्ट इवेंट के लिए endpoint.test।
क्या localhost या किसी प्राइवेट नेटवर्क पर वेबहुक भेजे जा सकते हैं?
नहीं। एंडपॉइंट सार्वजनिक https:// URL होने चाहिए। जो पते प्राइवेट, लूपबैक, लिंक-लोकल या आंतरिक रेंज में रिज़ॉल्व होते हैं, उन्हें सेव करते समय ही अस्वीकार कर दिया जाता है।
किस प्लान में वेबहुक शामिल हैं?
वेबहुक Standard प्लान और उससे ऊपर के प्लान में, API और MCP के साथ, डेवलपर सुविधाओं का हिस्सा हैं।
बैंक डेटा, सीधे आपके एंडपॉइंट पर।
BankSync, Webhooks से संबद्ध नहीं है, न ही उसके द्वारा समर्थित है और न ही उसका आधिकारिक पार्टनर है। Webhooks के ट्रेडमार्क उनके संबंधित स्वामियों के हैं।
