आपको एक अमेरिकी बैंक राउटिंग नंबर को मान्य करने और बैंक का कानूनी नाम, पता, फोन, ACH क्षमता और स्थिति खींचने की आवश्यकता है ताकि आप बिना किसी देरी के भुगतान या KYC प्रवाह भेज सकें। इस गाइड के अंत तक, आप Zyla API Hub पर राउटिंग नंबर बैंक लुकअप एपीआई को क्वेरी करेंगे, परिणामों को पार्स करेंगे, और इसे इस सप्ताह अपने वित्तीय कार्यप्रवाह में एकीकृत करेंगे।
यह एपीआई क्या करती है और इसका उपयोग कब करें
राउटिंग नंबर बैंक लुकअप एपीआई दिए गए अमेरिकी राउटिंग नंबर के लिए प्राधिकृत विवरण लौटाती है। यह यह मान्य कर सकती है कि राउटिंग नंबर सही है और वित्तीय संस्थान का नाम, शाखा प्रकार (जैसे, मुख्य कार्यालय), पता, फोन नंबर, सक्रिय स्थिति, और अंतिम अद्यतन तिथि प्रदान कर सकती है। सामान्य उपयोग के मामले शामिल हैं:
- भुगतान विफलताओं को कम करने के लिए ACH ऑनबोर्डिंग फॉर्म पर राउटिंग नंबरों को पूर्व-मान्य करना।
- लेखा, भुगतान, या ट्रेजरी सिस्टम में बैंक रिकॉर्ड को समृद्ध करना।
- डेबिट या क्रेडिट शुरू करने से पहले ACH पात्रता की पुष्टि करना।
- समर्थन टीमों के लिए बैक-ऑफिस उपकरण बनाना ताकि वे जल्दी से लौटाए गए भुगतानों को हल कर सकें।
यह एपीआई Zyla API Hub पर वित्त और भुगतान से संबंधित है, जो एकल खाता, एक एपीआई कुंजी, और 10,000 से अधिक सार्वजनिक एपीआई के बीच एकीकृत सदस्यता मॉडल प्रदान करता है।
Zyla API Hub पर शुरू करना
एंडपॉइंट्स को कॉल करने के लिए, Zyla API Hub पर एपीआई लिस्टिंग पर जाएं, सब्सक्राइब पर क्लिक करें या ट्रायल शुरू करें, और अपनी एपीआई कुंजी प्राप्त करें। प्रमाणीकरण हेडर में Authorization: Bearer YOUR_API_KEY के माध्यम से है।
- बिलिंग सदस्यता + कोटा है (पे-पर-कॉल नहीं)। पहला एपीआई 7-दिन का ट्रायल या 50 अनुरोध प्रदान करता है। कोई मुफ्त योजना नहीं है।
- वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए, मार्केटप्लेस पर एपीआई पृष्ठ देखें।
यहां से शुरू करें: राउटिंग नंबर बैंक लुकअप एपीआई पर 7-दिन का ट्रायल शुरू करें
आप जिन एंडपॉइंट्स का उपयोग करेंगे
नीचे मार्केटप्लेस पर सूचीबद्ध उपलब्ध एंडपॉइंट्स हैं। केवल स्पष्ट रूप से परिभाषित पैरामीटर का समर्थन किया जाता है—अतिरिक्त कुंजी या अनुरोध निकाय न जोड़ें।
1) बैंक जानकारी प्राप्त करें
विधि: GET
URL: https://zylalabs.com/api/331/routing-number-bank-lookup-api/266/get-bank-information
विवरण: एक राउटिंग नंबर के बारे में विस्तृत जानकारी प्राप्त करें। एंडपॉइंट वित्तीय संस्थान का नाम, ACH राउटिंग नंबर, शाखा प्रकार, पता, संपर्क जानकारी, सक्रिय स्थिति, और अंतिम अद्यतन की तारीख लौटाता है।
आवश्यक क्वेरी पैरामीटर:
- 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: इस लुकअप के लिए, “ach” भुगतान रेल संदर्भ की पहचान करता है।
- data.name, data.addressFull, data.phone: प्रदर्शन, सत्यापन, और समर्थन कार्यप्रवाह के लिए।
- data.type: शाखा प्रकार जैसे “मुख्य कार्यालय।”
- data.active: इंगित करता है कि राउटिंग रिकॉर्ड सक्रिय है या नहीं।
- data.lastUpdated: कैश अमान्यकरण और ऑडिटिंग के लिए तिथि स्ट्रिंग।
2) बैंक डेटा
विधि: GET
URL: https://zylalabs.com/api/331/routing-number-bank-lookup-api/1353/bank-data
विवरण: किसी भी बैंक के बारे में विस्तृत जानकारी प्राप्त करें, इसके राउटिंग नंबर को देखकर। यह यह भी मान्य करता है कि प्रदान किया गया राउटिंग नंबर सही है और बैंक का नाम, पता, और संपर्क जानकारी जैसे आवश्यक विवरण लौटाता है।
आवश्यक क्वेरी पैरामीटर:
- number (संख्या): जैसे, 304082876
cURL कॉपी-पेस्ट करें:
आधिकारिक उदाहरण प्रतिक्रिया:
आप जिन प्रमुख क्षेत्रों का उपयोग करेंगे:
- status, success, message: त्वरित मान्यता और UX संदेश।
- data.routing_number: क्वेरी किया गया नंबर, मान्य।
- data.bank, data.address, data.city, data.state, data.zip, data.phone: संपर्क और भू-स्थानिक समृद्धि।
- data.date_of_revision: सामंजस्य और ऑडिट समयसीमा के लिए उपयोगी।
पायथन उदाहरण (उत्पादन के अनुकूल)
नीचे दिया गया स्निपेट Get Bank Information को क्वेरी करता है और प्रतिक्रिया को सुरक्षित रूप से पार्स करता है। यह मार्केटप्लेस लिस्टिंग द्वारा आवश्यक सटीक URL और पैरामीटर का उपयोग करता है।
import os
import requests
from datetime import datetime
API_KEY = os.getenv("ZYLALABS_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":
raise RuntimeError(f"Lookup failed: {payload}")
bank = payload.get("data", {})
name = bank.get("name")
routing = bank.get("routingNumber")
ach_type = bank.get("paymentType")
active = bank.get("active")
updated = bank.get("lastUpdated") # जैसे, "2026-07-29"
# वैकल्पिक: कैश नियंत्रण या SLA लॉगिंग के लिए तिथि पार्स करें
updated_dt = None
if updated:
try:
updated_dt = datetime.strptime(updated, "%Y-%m-%d")
except ValueError:
pass
print({
"routingNumber": routing,
"name": name,
"paymentType": ach_type,
"active": active,
"address": bank.get("addressFull"),
"city": bank.get("city"),
"state": bank.get("state"),
"zip": bank.get("zip"),
"phone": bank.get("phone"),
"type": bank.get("type"),
"lastUpdated": updated
})समय बचाने वाले कार्यान्वयन नोट्स
- Auth: हमेशा Authorization: Bearer YOUR_API_KEY भेजें।
- Transport: दोनों एंडपॉइंट्स HTTP GET हैं जिनमें क्वेरी पैरामीटर हैं; अनुरोध निकाय शामिल न करें।
- Caching: डेटा.lastUpdated (Get Bank Information) या data.date_of_revision (Bank Data) का उपयोग करें यह तय करने के लिए कि कब अपने कैश को ताज़ा करना है। स्थिर राउटिंग नंबरों के लिए 24–48 घंटे का TTL विचार करें जब तक कि आपका जोखिम दृष्टिकोण अधिक सख्त ताजगी की आवश्यकता न हो।
- Validation UX: बैंक डेटा के लिए, संदेश क्षेत्र (जैसे, “राउटिंग बैंक 304082876 मान्य है”) को अपने फॉर्म फीडबैक के साथ इनलाइन करें। केवल तभी भुगतान शुरू करें जब सफलता सत्य हो।
- Normalization: पते पूर्ण स्ट्रिंग और घटकों (सड़क, शहर, राज्य, ज़िप) के रूप में लौटाए जाते हैं। PDFs और ईमेल में सुसंगत प्रारूपण के लिए घटकों को प्राथमिकता दें।
- त्रुटि हैंडलिंग: डेटा फ़ील्ड पर भरोसा करने से पहले HTTP स्थिति कोड और शीर्ष स्तर की स्थिति/सफलता संकेतकों की जांच करें।
- लॉगिंग: ऑडिट ट्रेल के लिए अपने उपयोगकर्ता/सत्र के साथ routingNumber/routing_number, name/bank, और lastUpdated/date_of_revision को रिकॉर्ड करें।
एंड-टू-एंड उदाहरण
उपयोग का मामला: ACH ऑनबोर्डिंग फॉर्म
- राउटिंग नंबर इनपुट के ब्लर पर, संख्या को 9-अंक के राउटिंग नंबर पर सेट करके बैंक डेटा को कॉल करें।
- यदि सफलता सत्य है, तो उपयोगकर्ता के लिए पुष्टि के रूप में data.bank, city/state, और phone प्रदर्शित करें।
- वैकल्पिक रूप से, सक्रिय स्थिति और शाखा प्रकार की पुष्टि करने के लिए उसी राउटिंग नंबर और paymentType=ach के साथ Get Bank Information को कॉल करें इससे पहले कि “लिंक खाता” बटन सक्षम हो।
- दोहराए गए लुकअप से बचने के लिए सत्र के लिए राउटिंग नंबर द्वारा कुंजीबद्ध परिणामों को कैश करें।
उपयोग का मामला: भुगतान रेल संतुलन जांच
- ACH क्रेडिट शुरू करने से पहले, paymentType=ach के साथ Get Bank Information को कॉल करें।
- सुनिश्चित करें कि सक्रिय सत्य है। यदि झूठा या अनुपस्थित है, तो भुगतान को रोकें और मामले को समर्थन के लिए मार्गदर्शित करें।
- अनुपालन और सामंजस्य रिपोर्टिंग के लिए lastUpdated को लॉग करें।
उपयोग का मामला: बैक-ऑफिस बैंक समृद्धि
- अपने राउटिंग नंबरों को बैच करें और बैंक डेटा को समृद्ध करने के लिए कॉल करें, पता, और फोन।
- जहां उपलब्ध हो, Get Bank Information को जोड़ें ताकि एजेंटों के लिए शाखा प्रकार और addressFull शामिल हो सके।
- अपने CS उपकरणों में सामान्यीकृत फ़ील्ड को निर्यात करें ताकि एजेंट विवादों के दौरान शहर/राज्य द्वारा खोज कर सकें।
AI एजेंटों द्वारा MCP के माध्यम से कॉल करना
आप Zyla के MCP एंडपॉइंट का उपयोग करके AI कोडिंग एजेंट या MCP-संगत क्लाइंट से समान लुकअप चला सकते हैं। अपने MCP क्लाइंट को इस पर इंगित करें:
अपने API कुंजी को apikey क्वेरी पैरामीटर (YOUR_API_KEY) का उपयोग करके सेट करें। वहां से, एजेंट को ऊपर दिखाए गए सटीक हब URLs पर HTTP GET करने के लिए निर्देशित करें, जिसमें आवश्यक क्वेरी पैरामीटर और Authorization हेडर शामिल हैं। एजेंट को समान JSON संरचनाएं प्राप्त होंगी, इसलिए आप अपने एजेंट कार्यप्रवाह के भीतर उपकरण कॉल को श्रृंखला में जोड़ सकते हैं (जैसे, एक राउटिंग नंबर को मान्य करें, फिर एक प्रारूपित पुष्टि को रेंडर करें)।
एंडपॉइंट पुनर्कथन और फ़ील्ड मैपिंग
- बैंक जानकारी प्राप्त करें (GET)
- URL: https://zylalabs.com/api/331/routing-number-bank-lookup-api/266/get-bank-information
- पैरामीटर: routingnumber (संख्या), paymentType (स्ट्रिंग)
- लौटाता है: routingNumber, paymentType, name, addressFull, street, city, state, zip, type, phone, active, lastUpdated
- बैंक डेटा (GET)
- URL: https://zylalabs.com/api/331/routing-number-bank-lookup-api/1353/bank-data
- पैरामीटर: number (संख्या)
- लौटाता है: status, success, message, data.routing_number, data.date_of_revision, data.new_routing_number, data.bank, data.address, data.city, data.state, data.zip, data.phone
संचालनात्मक मार्गदर्शन
- सुरक्षा: अपने सर्वर-साइड वातावरण में YOUR_API_KEY को स्टोर करें, क्लाइंट-साइड कोड में नहीं।
- पुनः प्रयास: अस्थायी 5xx प्रतिक्रियाओं के लिए, गुणात्मक बैकऑफ लागू करें। मान्यता विफलताओं (जहां सफलता झूठी है या स्थिति एक अमान्य संख्या को इंगित करती है) को पुनः प्रयास न करें; इसके बजाय इनपुट को ठीक करें।
- पर्यवेक्षण: उपयोगकर्ता द्वारा दर्ज किए गए राउटिंग नंबरों को समस्या निवारण के लिए अनुरोध पैरामीटर और लौटाई गई स्थिति/सफलता दोनों को लॉग करें।
- अंतर्राष्ट्रीयकरण: ये एंडपॉइंट अमेरिकी राउटिंग नंबरों के लिए डिज़ाइन किए गए हैं। इन्हें गैर-अमेरिकी खाता पहचानकर्ताओं पर लागू करने से बचें।
- परिवर्तन प्रबंधन: यदि डेटा में महत्वपूर्ण परिवर्तन हुआ है तो अपनी टीम को सूचित करने या पुनः मान्यता प्रवाह को ट्रिगर करने के लिए lastUpdated और date_of_revision संकेतों का उपयोग करें।
त्वरित संदर्भ cURLs
बैंक जानकारी प्राप्त करें (ACH):
बैंक डेटा (राउटिंग मान्य करें):
अगला कहां जाना है
इस और अन्य वित्त और भुगतान एपीआई का अन्वेषण करें Zyla API Hub पर। अपना खाता बनाएं, सब्सक्राइब करें, और एकल एपीआई कुंजी का उपयोग करके कई सेवाओं में अपने एकीकरण को तेज करें। जब आप लाइव परीक्षण करने के लिए तैयार हों, तो यहां से शुरू करें: राउटिंग नंबर बैंक लुकअप एपीआई पर 7-दिन का ट्रायल शुरू करें। आप कभी भी Zyla API Hub कैटलॉग से अधिक एपीआई ब्राउज़ कर सकते हैं।
अक्सर पूछे जाने वाले प्रश्न
क्या इन एंडपॉइंट्स के लिए कोई अनुरोध निकाय है?
नहीं। दोनों एंडपॉइंट्स केवल क्वेरी पैरामीटर के साथ GET हैं। JSON निकाय न भेजें।
मैं प्रमाणीकरण कैसे करूं?
अनुरोध हेडर में Authorization: Bearer YOUR_API_KEY जोड़ें।
क्या मैं इन एंडपॉइंट्स का उपयोग गैर-ACH रेल की जांच करने के लिए कर सकता हूं?
Get Bank Information को प्रदान किए गए नमूना पथ को कॉल करते समय paymentType=ach की आवश्यकता होती है। यदि आपको अन्य रेल की आवश्यकता है, तो उपलब्ध विकल्पों के लिए एपीआई पृष्ठ की जांच करें।
मुझे क्या कैश करना चाहिए?
राउटिंग नंबर के अनुसार प्रतिक्रिया को कैश करें। यह तय करने के लिए lastUpdated (Get Bank Information) या date_of_revision (Bank Data) का उपयोग करें कि कब ताज़ा करना है।
क्या कोई मुफ्त योजना है?
कोई मुफ्त योजना नहीं है। पहला एपीआई 7-दिन का ट्रायल या 50 अनुरोध प्रदान करता है। वर्तमान पहुंच विकल्पों के लिए एपीआई लिस्टिंग देखें।
