आपको एक यू.एस. बैंक राउटिंग नंबर को मान्य करने की आवश्यकता है और बैंक का कानूनी नाम, पता, संपर्क और स्थिति निकालनी है ताकि आपका एसीएच कार्यप्रवाह पे-डे पर न बाउंस हो। इस लेख के अंत तक, आप एक राउटिंग नंबर को क्वेरी करने, इसकी वैधता की पुष्टि करने और राउटिंग नंबर बैंक लुकअप एपीआई का उपयोग करके अपने वित्तीय ऐप में लौटाए गए संस्थान के मेटाडेटा को स्टोर करने में सक्षम होंगे।
यह एपीआई क्या प्रदान करता है और इसका उपयोग कब करें
राउटिंग नंबर बैंक लुकअप एपीआई एक दिए गए यू.एस. राउटिंग नंबर के लिए प्राधिकृत बैंक विवरण लौटाता है। यह कवर करता है:
- यह पुष्टि करना कि एक राउटिंग नंबर सही है।
- संस्थान की पहचान: बैंक का नाम, शाखा का प्रकार (जैसे, मुख्य कार्यालय)।
- संपर्क विवरण: पूरा पता, फोन।
- संचालनात्मक ध्वज: सक्रिय स्थिति और अंतिम अद्यतन तिथि।
इस एपीआई का उपयोग करने वाले सामान्य वित्तीय एकीकरण में एसीएच ऑनबोर्डिंग, भुगतान कॉन्फ़िगरेशन, भुगतान संचालन डैशबोर्ड, केवाईसी/केवाईबी सत्यापन चरण, और फंड मूवमेंट से पहले आंतरिक जोखिम जांच शामिल हैं।
ज़ायला एपीआई हब पर शुरुआत करना
ज़ायला एपीआई हब पर राउटिंग नंबर बैंक लुकअप एपीआई पृष्ठ खोलें और अपनी कुंजी प्राप्त करने के लिए एक परीक्षण शुरू करें। ज़ायला एक एपीआई कुंजी जारी करता है जिसका उपयोग आप बाजार में एक सदस्यता + कोटा मॉडल (पे-पर-कॉल नहीं) के साथ कर सकते हैं। पहला एपीआई अक्सर 7-दिन का परीक्षण या 50 अनुरोध प्रदान करता है; वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए एपीआई पृष्ठ की जांच करें।
राउटिंग नंबर बैंक लुकअप एपीआई पर 7-दिन का परीक्षण शुरू करें
आप जिन एंडपॉइंट्स का उपयोग करेंगे
एपीआई दो GET एंडपॉइंट्स को उजागर करता है जिन्हें आप सीधे अपने बैकएंड या कार्यकर्ता नौकरियों से कॉल कर सकते हैं। सभी कॉल्स को आपकी ज़ायला एपीआई कुंजी के साथ प्राधिकरण हेडर की आवश्यकता होती है।
1) बैंक जानकारी प्राप्त करें
इसका उपयोग तब करें जब आपके पास एक राउटिंग नंबर और एक भुगतान प्रकार हो और आपको स्थिति और अंतिम अद्यतन तिथि सहित पूर्ण बैंक मेटाडेटा की आवश्यकता हो।
- विधि: GET
- यूआरएल: https://zylalabs.com/api/331/routing-number-bank-lookup-api/266/get-bank-information
- आवश्यक क्वेरी पैरामीटर:
- routingnumber (संख्या): जैसे, 121000245
- paymentType (स्ट्रिंग): जैसे, ach
cURL कॉपी-पेस्ट करें (प्राधिकरण हेडर आवश्यक):
curl -s -X GET "https://zylalabs.com/api/331/routing-number-bank-lookup-api/266/get-bank-information?routingnumber=121000245&paymentType=ach" \
-H "Authorization: Bearer YOUR_API_KEY"आधिकारिक उदाहरण प्रतिक्रिया:
{
"status": "success",
"data": {
"routingNumber": "121000245",
"paymentType": "ach",
"name": "Wells Fargo Bank, Na",
"addressFull": "255 2nd Ave South, Minneapolis, MN 55479",
"street": "255 2nd Ave South",
"city": "Minneapolis",
"state": "MN",
"zip": "55479",
"type": "Main Office",
"phone": "800-245-2426",
"active": true,
"lastUpdated": "2026-07-29"
}
}आप जिन फ़ील्ड हाइलाइट्स का वास्तव में उपयोग करेंगे:
- data.routingNumber और data.paymentType: आपके इनपुट को सहसंबंध के लिए दर्शाते हैं।
- data.name, data.type: पुष्टि स्क्रीन और बैंक-मैचिंग लॉजिक पर उपयोग करें।
- data.addressFull (प्लस स्ट्रीट/सिटी/स्टेट/ज़िप): ऑडिट या समर्थन कार्यप्रवाह के लिए स्टोर करें।
- data.phone: मैनुअल सत्यापन प्रक्रियाओं के लिए उपयोगी।
- data.active: यदि गलत हो तो भुगतान रोकें।
- data.lastUpdated: एक दिनांक स्ट्रिंग जिसे आप अपने कैश में डेटा ताजगी का मूल्यांकन करने के लिए लॉग कर सकते हैं।
2) बैंक डेटा
इसका उपयोग तब करें जब आपके पास केवल एक राउटिंग नंबर हो और आप कोर संस्थान विवरण के साथ एक मान्यता परिणाम चाहते हों।
- विधि: GET
- यूआरएल: https://zylalabs.com/api/331/routing-number-bank-lookup-api/1353/bank-data
- आवश्यक क्वेरी पैरामीटर:
- number (संख्या): जैसे, 304082876
cURL कॉपी-पेस्ट करें:
उदाहरण प्रतिक्रिया:
मैप करने के लिए प्रमुख फ़ील्ड:
- success और message: UI या बैच जांचों के लिए त्वरित मान्यता संकेत।
- data.routing_number: सामान्यीकृत राउटिंग नंबर जिसे आपने देखा।
- data.bank, data.address, data.city, data.state, data.zip, data.phone: कोर बैंक प्रोफ़ाइल।
- data.date_of_revision: दिनांक स्ट्रिंग जो बताती है कि रिकॉर्ड को अंतिम बार कब संशोधित किया गया था; सामंजस्य और कैश अमान्यकरण ह्यूरिस्टिक्स के लिए रखें।
पायथन में एंड-टू-एंड उदाहरण
नीचे दिया गया स्क्रिप्ट बैंक जानकारी प्राप्त करें को कॉल करता है, स्थिति की जांच करता है, और सामान्यीकृत फ़ील्ड को प्रिंट करता है जिन्हें आप सामान्यतः बनाए रखेंगे। यह ऊपर दिखाए गए सटीक यूआरएल और पैरामीटर का उपयोग करता है। YOUR_API_KEY को अपनी ज़ायला कुंजी से बदलें।
import os
import requests
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
URL = "https://zylalabs.com/api/331/routing-number-bank-lookup-api/266/get-bank-information"
params = {
"routingnumber": "121000245",
"paymentType": "ach",
}
headers = {
"Authorization": f"Bearer {API_KEY}",
}
resp = requests.get(URL, params=params, headers=headers, timeout=15)
resp.raise_for_status()
payload = resp.json()
if payload.get("status") != "success" or "data" not in payload:
raise SystemExit(f"Lookup failed or unexpected response: {payload}")
data = payload["data"]
normalized = {
"routing_number": data.get("routingNumber"),
"payment_type": data.get("paymentType"),
"bank_name": data.get("name"),
"branch_type": data.get("type"),
"address_full": data.get("addressFull"),
"city": data.get("city"),
"state": data.get("state"),
"zip": data.get("zip"),
"phone": data.get("phone"),
"active": data.get("active"),
"last_updated": data.get("lastUpdated"),
}
print("Validated bank record:")
for k, v in normalized.items():
print(f"{k}: {v}")
# उदाहरण: सरल गेटिंग लॉजिक
if not normalized["active"]:
raise SystemExit("Bank routing is not active; block ACH setup.")
# अपने डेटा स्टोर में बनाए रखें या यहां ऑनबोर्डिंग प्रवाह जारी रखें।अपने प्रवाह के लिए सही एंडपॉइंट चुनना
- जब आपको सक्रिय ध्वज, प्रकार (जैसे, मुख्य कार्यालय), और एक स्पष्ट lastUpdated तिथि की आवश्यकता हो, तो बैंक जानकारी प्राप्त करें के लिए उपयोग करें, साथ ही एक संरचित पता और एसीएच भुगतान प्रकार संदर्भ।
- कोर संस्थान के प्रोफ़ाइल फ़ील्ड और एक मान्यता संदेश लौटाने के लिए बैंक डेटा का उपयोग करें।
यदि आपका कार्यप्रवाह त्वरित मान्यता जांच (बैंक डेटा) से शुरू होता है और सफल मान्यताओं या हाल ही में कैश किए गए बैंकों के लिए समृद्ध प्रोफ़ाइल खींचने के लिए बढ़ता है, तो आप उन्हें संयोजित कर सकते हैं।
समय बचाने वाले व्यावहारिक कार्यान्वयन नोट्स
- प्रमाणीकरण: हर अनुरोध पर Authorization: Bearer YOUR_API_KEY सेट करें। क्वेरी पैरामीटर में कुंजी न भेजें।
- कैशिंग: राउटिंग नंबर स्थिर पहचानकर्ता हैं। सफल लुकअप को routingNumber द्वारा की गई कैश करें। यह तय करने के लिए lastUpdated या date_of_revision का उपयोग करें कि क्या आपको ताज़ा करने की आवश्यकता है। परिवर्तित रिकॉर्ड के लिए दैनिक ताज़ा कार्य एक सामान्य पैटर्न है।
- सामान्यीकरण: पूरे पते की स्ट्रिंग और टूटे हुए फ़ील्ड दोनों को स्टोर करें। पूरा स्ट्रिंग प्रदर्शन और समर्थन टिकटों के लिए सुविधाजनक है, जबकि अलग फ़ील्ड खोज और मिलान के लिए बेहतर हैं।
- डेटा ताजगी: lastUpdated (बैंक जानकारी प्राप्त करें) एक दिनांक स्ट्रिंग है। date_of_revision (बैंक डेटा) भी एक दिनांक स्ट्रिंग है। इन्हें ऑडिट लॉग के लिए बनाए रखें।
- एसीएच संदर्भ: बैंक जानकारी प्राप्त करें में paymentType=ach आवश्यक है। अपने क्लाइंट में इस पैरामीटर को स्पष्ट रखें ताकि आपके अपस्ट्रीम लॉजिक में आकस्मिक असंगतियों से बचा जा सके।
- Idempotence: यदि आप एक ही routingnumber क्वेरी को फिर से चलाते हैं, तो प्रतिक्रियाएँ अपरिवर्तित रिकॉर्ड के लिए निर्धारक होती हैं। यह पुनः प्रयास के दौरान कॉल करना सुरक्षित बनाता है।
- लॉगिंग: केवल राउटिंग नंबर को लॉग करें जिसे आपने अनुरोध किया और स्थिति/सफलता फ़ील्ड। एपीआई कुंजी को लॉग करने से बचें।
सामान्य वित्तीय उपयोग के मामले
- एसीएच ऑनबोर्डिंग: अपने "बैंक खाता लिंक करें" फॉर्म पर राउटिंग नंबर को मान्य करें, उपयोगकर्ता को बैंक का नाम और शहर वापस दिखाएं, और भुगतान शुरू करने से पहले सक्रिय ध्वज को स्टोर करें।
- भुगतान संचालन: एक भुगतान फ़ाइल को संसाधित करने से पहले, यह सुनिश्चित करने के लिए एक बैच जांच चलाएँ कि सभी राउटिंग नंबर सफलता/सक्रिय=true लौटाते हैं; अमान्य प्रविष्टियों को अस्वीकार या क्वारंटाइन करें।
- अनुपालन और जोखिम: प्रतिपक्ष की समीक्षाओं और आंतरिक ऑडिट कलाकृतियों के लिए बैंक का कानूनी नाम और पता फ़ाइल पर रखें।
- ग्राहक समर्थन: उपयोगकर्ताओं की सहायता के लिए लौटाए गए फोन और पते का उपयोग करें जिन्होंने राउटिंग नंबर को गलत टाइप किया या मैनुअल समीक्षाओं के दौरान संस्थान के विवरण की पुष्टि करें।
परीक्षण और मान्यता टिप्स
- यूनिट परीक्षण: ऊपर दिखाए गए दो प्रतिक्रिया आकारों को स्टब करें। जब स्थिति "सफलता" नहीं होती है (बैंक जानकारी प्राप्त करें) या सफलता गलत होती है (बैंक डेटा) तो सफलता पथों और गार्ड रेलों के लिए परीक्षण करें।
- यूआई पुष्टि: टाइपिंग गलतियों को जल्दी पकड़ने के लिए अंतिम उपयोगकर्ता को बैंक का नाम, शहर और राज्य दर्शाएं, इससे पहले कि आप सूक्ष्म-डिपॉजिट करें या फंड निकालें।
- बैच नौकरियां: रात या घंटे की मान्यताओं के लिए, राउटिंग नंबर प्रीफिक्स द्वारा नौकरियों को विभाजित करें ताकि बिना अपने कोटा को संतृप्त किए समानांतर रूप से चल सके।
- निगरानी: जल्दी से इनबाउंड डेटा गुणवत्ता मुद्दों को पहचानने के लिए "अमान्य राउटिंग नंबरों" के अनुपात को कुल प्रयासों के साथ ट्रैक करें।
एआई एजेंटों के माध्यम से एपीआई को कॉल करना MCP
यदि आपकी टीम MCP-संगत कोडिंग एजेंटों का उपयोग करती है (जैसे, संपादकों में), तो आप इस एपीआई को ज़ायला के MCP गेटवे के माध्यम से उजागर कर सकते हैं। कोई भी एजेंट जो MCP का समर्थन करता है, आपकी कुंजी को MCP के माध्यम से टनल करके समान GET एंडपॉइंट्स को कॉल कर सकता है। यहां प्रोटोकॉल और कनेक्शन विवरण देखें: MCP.
बुनियादी दृष्टिकोण:
- अपने MCP क्लाइंट को ज़ायला MCP एंडपॉइंट और अपनी एपीआई कुंजी के साथ कॉन्फ़िगर करें।
- एजेंट के उपकरण निष्पादन के भीतर, अपने बैकएंड से उपयोग किए जाने वाले सटीक एंडपॉइंट यूआरएल पर GET जारी करें, जिसमें प्राधिकरण हेडर शामिल है।
- JSON को पार्स करें और महत्वपूर्ण फ़ील्ड (बैंक का नाम, पता, सक्रिय ध्वज) को अपने कोड जनरेशन या डेटा माइग्रेशन कार्य में वापस फीड करें।
चूंकि MCP ब्रिज आपके अनुरोधों को फॉरवर्ड करता है, इसलिए इस लेख में दिखाए गए समान यूआरएल, पैरामीटर और प्रतिक्रिया प्रारूप बिना किसी परिवर्तन के लागू होते हैं।
त्रुटि हैंडलिंग पैटर्न
ऊपर दिए गए उदाहरण सफल पेलोड दिखाते हैं। उत्पादन में, लागू करें:
- HTTP-स्तरीय हैंडलिंग: अपने पुनः प्रयास नीति के आधार पर गैर-2xx को अस्थायी या टर्मिनल के रूप में मानें। सुनिश्चित करें कि आप अपनी सदस्यता कोटा से अधिक न हों।
- पेलोड मान्यता: डेटा फ़ील्ड पर भरोसा करने से पहले बैंक जानकारी प्राप्त करें के लिए स्थिति "सफलता" के बराबर और बैंक डेटा के लिए सफलता "सत्य" के बराबर है।
- उपयोगकर्ता संदेश: अमान्य राउटिंग नंबरों पर, उपयोगकर्ता से उनके बैंक विवरण को फिर से जांचने के लिए एक संक्षिप्त UI संदेश लौटाएं।
सुरक्षा और तैनाती नोट्स
- अपनी ज़ायला एपीआई कुंजी को सर्वर साइड पर रखें; कभी भी इसे क्लाइंट-साइड कोड में एम्बेड न करें।
- कुंजियों को समय-समय पर और कर्मचारियों में बदलाव पर घुमाएं। अपने CI/CD सीक्रेट स्टोर को तदनुसार अपडेट करें।
- केवल उन सेवाओं तक पहुंच सीमित करें जिन्हें इसकी आवश्यकता है (जैसे, भुगतान सेवा, ऑनबोर्डिंग कार्यकर्ता)।
- अपने बुनियादी ढांचे में एक पतला प्रॉक्सी पर विचार करें ताकि लॉगिंग और पुनः प्रयासों को केंद्रीकृत किया जा सके, लेकिन कुंजी को स्वयं लॉग न करें।
फील्ड मैपिंग चेकलिस्ट
- प्राथमिक कुंजी: राउटिंग नंबर (स्ट्रिंग)।
- पहचान: बैंक का नाम; शाखा का प्रकार (यदि उपलब्ध हो)।
- संपर्क: addressFull; street/city/state/zip; फोन।
- स्थिति: सक्रिय (बूलियन) बैंक जानकारी प्राप्त करें से; सफलता और संदेश बैंक डेटा से।
- ताजगी: lastUpdated (बैंक जानकारी प्राप्त करें) या date_of_revision (बैंक डेटा)।
- ऑडिट: अपने सिस्टम लॉग में लुकअप के सटीक क्वेरी पैरामीटर और टाइमस्टैम्प को स्टोर करें।
सब कुछ एक साथ रखना
इस सप्ताह अधिकांश वित्तीय एकीकरण के लिए:
- राउटिंग नंबर बैंक लुकअप एपीआई पृष्ठ पर, सदस्यता लें और अपनी एपीआई कुंजी प्राप्त करें।
- क्लाइंट-साइड फॉर्म प्रारूप को मान्य करता है; बैकएंड बैंक डेटा के लिए त्वरित मान्यता के लिए कॉल करता है।
- यदि मान्य है, तो सक्रिय स्थिति और पूर्ण प्रोफ़ाइल प्राप्त करने के लिए बैंक जानकारी प्राप्त करें को कॉल करें।
- कैश शासन के लिए lastUpdated या date_of_revision के साथ रिकॉर्ड को स्टोर करें।
- सक्रिय होने पर एसीएच सेटअप या भुगतान को गेट करें।
यह प्रवाह आपको एक तेज़ मान्यकर्ता और दो सरल GET अनुरोधों का उपयोग करके एक गहरा प्रोफ़ाइल खींचने दोनों देता है।
अक्सर पूछे जाने वाले प्रश्न
दोनों एंडपॉइंट्स के बीच क्या अंतर है?
बैंक जानकारी प्राप्त करें एक समृद्ध प्रोफ़ाइल लौटाता है जिसमें सक्रिय, प्रकार, और lastUpdated जैसे फ़ील्ड होते हैं और इसे routingnumber और paymentType की आवश्यकता होती है। बैंक डेटा एक राउटिंग नंबर को मान्य करता है और संख्या दी गई कोर संस्थान विवरण लौटाता है।
मुझे पहले कौन सा एंडपॉइंट कॉल करना चाहिए?
यदि आपको त्वरित मान्यता जांच की आवश्यकता है, तो बैंक डेटा से शुरू करें। यदि आप पहले से जानते हैं कि आपको सक्रिय ध्वज और पूर्ण पता विवरण की आवश्यकता है, तो सीधे बैंक जानकारी प्राप्त करें का उपयोग करें।
मैं प्रमाणीकरण कैसे करूँ?
हर अनुरोध पर Authorization: Bearer YOUR_API_KEY शामिल करें। कुंजी को क्वेरी पैरामीटर के रूप में न भेजें।
क्या कोई मुफ्त योजना है?
ज़ायला एपीआई सदस्यता + कोटा मॉडल पर चलते हैं, न कि पे-पर-कॉल। आपके पहले एपीआई के लिए, आपको आमतौर पर 7-दिन का परीक्षण या 50 अनुरोध मिलते हैं। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए एपीआई पृष्ठ की जांच करें।
क्या मैं इसका उपयोग एसीएच सेटअप के लिए कर सकता हूँ?
हाँ। बैंक जानकारी प्राप्त करें paymentType=ach को स्वीकार करता है और बैंक की सक्रिय स्थिति और पूर्ण प्रोफ़ाइल लौटाता है, जिसका उपयोग सामान्यतः एसीएच खाता निर्माण और भुगतान को गेट करने के लिए किया जाता है।
राउटिंग नंबरों को मान्य करने और अपने एकीकरण को शिप करने के लिए तैयार हैं? यहां राउटिंग नंबर बैंक लुकअप एपीआई पर अपना खाता बनाएं और अपना परीक्षण शुरू करें: राउटिंग नंबर बैंक लुकअप एपीआई पर 7-दिन का परीक्षण शुरू करें. ज़ायला पर 10,000 से अधिक सार्वजनिक एपीआई के साथ, आप एकल जांच से लेकर एक पूर्ण वित्तीय स्टैक तक उसी कुंजी और सदस्यता मॉडल का उपयोग करके स्केल कर सकते हैं।
