आपको अमेरिका के बैंक राउटिंग नंबरों की पुष्टि करनी होगी, आधिकारिक संस्थान का नाम और पता निकालना होगा, और यह तय करना होगा कि क्या आप इस सप्ताह एक ACH सुरक्षित रूप से भेज सकते हैं। इस लेख के अंत तक, आप राउटिंग नंबरों को मान्य करने और बैंक मेटाडेटा प्राप्त करने के लिए दो उत्पादन एंडपॉइंट्स का उपयोग करेंगे, जिसका उपयोग आप भुगतान प्रारंभ, अनुपालन जांच और समर्थन कार्यप्रवाह के लिए कर सकते हैं।
इस एपीआई द्वारा प्रदान की जाने वाली सेवाएँ
राउटिंग नंबर बैंक लुकअप एपीआई अमेरिका के बैंक राउटिंग नंबरों के लिए प्रोग्रामेटिक सत्यापन और समृद्धि प्रदान करता है। आप:
- सत्यापित करें कि एक राउटिंग नंबर वास्तविक और सक्रिय है।
- वित्तीय संस्थान का नाम, शाखा प्रकार, ACH क्षमता, और संपर्क विवरण पहचानें।
- पुष्टिकरण और ऑडिट ट्रेल्स के लिए पता घटक (सड़क, शहर, राज्य, ज़िप) प्राप्त करें।
- डेटा ताजगी को समझने के लिए अंतिम अपडेट तिथि की जांच करें।
ये क्षमताएँ ACH ऑनबोर्डिंग प्रवाह, भुगतान स्वचालन, विक्रेता/आपूर्तिकर्ता प्रबंधन, और आंतरिक वित्त उपकरणों के लिए सामान्य निर्माण ब्लॉक हैं जिन्हें रिटर्न और समर्थन टिकटों को कम करने की आवश्यकता होती है।
Zyla API हब पर शुरू करना
Zyla API हब पर एपीआई की लिस्टिंग खोलें, सदस्यता लें, और अपनी कुंजी प्राप्त करें। Zyla API हब एक खाते, एक एपीआई कुंजी, और एक सदस्यता + कोटा मॉडल (पे-पर-कॉल नहीं) के पीछे 10,000 से अधिक सार्वजनिक एपीआई को केंद्रीकृत करता है। यहाँ पहला एपीआई 7-दिन की परीक्षण अवधि या 50 अनुरोध प्रदान करता है—वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए एपीआई पृष्ठ की जांच करें।
- राउटिंग नंबर बैंक लुकअप एपीआई पर 7-दिन का परीक्षण शुरू करें
- अन्य वित्तीय एपीआई ब्राउज़ करें Zyla API हब पर।
प्रमाणीकरण HTTP हेडर के माध्यम से है: Authorization: Bearer YOUR_API_KEY.
आज आप जिन एंडपॉइंट्स का उपयोग कर सकते हैं
1) बैंक जानकारी प्राप्त करें
विधि: GET
यूआरएल: https://zylalabs.com/api/331/routing-number-bank-lookup-api/266/get-bank-information
विवरण: एक राउटिंग नंबर के बारे में विस्तृत जानकारी लौटाता है, जिसमें संस्थान का नाम, ACH राउटिंग नंबर, शाखा प्रकार, पूरा पता, फोन, सक्रिय स्थिति, और अंतिम अपडेट तिथि शामिल है।
आवश्यक क्वेरी पैरामीटर:
- routingnumber (संख्या): उदाहरण के लिए, 121000245
- paymentType (स्ट्रिंग): ach
2) बैंक डेटा
विधि: GET
यूआरएल: https://zylalabs.com/api/331/routing-number-bank-lookup-api/1353/bank-data
विवरण: एक राउटिंग नंबर को मान्य करता है और बैंक के नाम, पते, और संपर्क जानकारी जैसे प्रमुख बैंक विवरण लौटाता है।
आवश्यक क्वेरी पैरामीटर:
- number (संख्या): उदाहरण के लिए, 304082876
कॉपी-पेस्ट cURL उदाहरण
बैंक जानकारी प्राप्त करें: ACH-सक्षम राउटिंग नंबर विवरण
दो आवश्यक क्वेरी पैरामीटर (routingnumber और paymentType) और अपनी बियरर टोकन के साथ GET भेजें:
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.type: ग्राहक को दिखाएँ कि आपने किस संस्थान/शाखा का पता लगाया।
- data.addressFull (या घटक): अपने ऑडिट लॉग या भुगतान पुष्टिकरण के लिए स्टोर करें।
- data.phone: वृद्धि के लिए समर्थन उपकरण में प्रदान करें।
- data.active: यदि निष्क्रिय है तो भुगतान को गेट करें और ACH रिटर्न को कम करें।
- data.lastUpdated: डेटा ताजगी के लिए टेलीमेट्री; आपकी तरफ से कैश अमान्यकरण नीतियों के लिए उपयोगी।
बैंक डेटा: संक्षिप्त बैंक प्रोफ़ाइल के साथ मान्यता
एकल आवश्यक पैरामीटर संख्या (राउटिंग नंबर) के साथ GET भेजें:
उदाहरण प्रतिक्रिया:
आप वास्तव में क्या उपयोग करेंगे:
- success और message: UI फीडबैक के लिए उपयुक्त तेज़ मान्यता जांच।
- data.routing_number: मान्य संख्या को प्रतिध्वनित करता है; इसे अपनी इकाई से मैप करें।
- data.bank, data.address, data.city, data.state, data.zip, data.phone: अपने विक्रेता/ग्राहक रिकॉर्ड को समृद्ध करें।
- data.date_of_revision और data.new_routing_number: अपडेट या पुनः असाइनमेंट का पता लगाएँ और उपयोगकर्ताओं को विवरण की पुष्टि करने के लिए प्रेरित करें।
Python उदाहरण: ACH प्रारंभ करने से पहले मान्य करें और समृद्ध करें
यह नमूना ACH राउटिंग नंबर की पुष्टि करने के लिए बैंक जानकारी प्राप्त करें, गतिविधि की जांच करता है, और भंडारण के लिए पता घटकों को सामान्य करता है।
import os
import requests
API_KEY = os.environ.get("ZYLA_API_KEY", "YOUR_API_KEY")
BASE_URL = "https://zylalabs.com/api/331/routing-number-bank-lookup-api/266/get-bank-information"
def get_bank_info(routing_number: str, payment_type: str = "ach") -> dict:
params = {
"routingnumber": routing_number,
"paymentType": payment_type,
}
headers = {
"Authorization": f"Bearer {API_KEY}"
}
resp = requests.get(BASE_URL, params=params, headers=headers, timeout=10)
resp.raise_for_status()
return resp.json()
if __name__ == "__main__":
rn = "121000245"
payload = get_bank_info(rn, "ach")
# न्यूनतम रक्षात्मक पार्सिंग
status = payload.get("status")
data = payload.get("data", {}) if status == "success" else {}
active = data.get("active", False)
if not active:
raise SystemExit(f"Routing number {rn} is not active for ACH.")
name = data.get("name")
phone = data.get("phone")
address_full = data.get("addressFull")
city = data.get("city")
state = data.get("state")
zip_code = data.get("zip")
last_updated = data.get("lastUpdated")
print("Validated bank:")
print(f"- Name: {name}")
print(f"- Phone: {phone}")
print(f"- Address: {address_full} ({city}, {state} {zip_code})")
print(f"- Last updated: {last_updated}")
नोट्स:
- भुगतान प्रवाह में लटकने वाली कॉल से बचने के लिए 5–10 सेकंड का टाइमआउट उपयोग करें।
- ट्रेसबिलिटी के लिए अपने भुगतान विधि के साथ प्रतिक्रिया को बनाए रखें।
- अपने कैश को ताज़ा करने के लिए data.lastUpdated का उपयोग करें। एक नीति चुनें जो आपके जोखिम सहिष्णुता से मेल खाती है; एपीआई एक TTL लागू नहीं करता है।
व्यावहारिक वित्तीय उपयोग के मामले जिन्हें आप इस सप्ताह भेज सकते हैं
- ACH ऑनबोर्डिंग गार्डरेल्स: जब बैंक विवरण एकत्र करते हैं, तो राउटिंग नंबर को सर्वर-साइड पर मान्य करें और यदि यह अमान्य या निष्क्रिय है तो एक स्पष्ट त्रुटि लौटाएँ। वैकल्पिक रूप से, उपयोगकर्ता की प्रविष्टि की गलतियों को कम करने के लिए पता लगाए गए बैंक का नाम और स्थान प्रदर्शित करें।
- भुगतान स्वचालन: बैच बनाने से पहले, प्रत्येक काउंटरपार्टी के राउटिंग नंबर को मान्यता के माध्यम से चलाएँ। निष्क्रिय प्रविष्टियों को छोड़ें या झंडा लगाएँ और त्वरित फॉलो-अप के लिए अपवाद रिपोर्ट में बैंक का फोन जोड़ें।
- विक्रेता मास्टर समृद्धि: पता घटकों को सामान्य करें और प्रत्येक विक्रेता के पसंदीदा भुगतान खाते से जुड़े बैंक जानकारी के लिए एकल सत्य का स्रोत बनाए रखें।
- चार्जबैक/रिटर्न ट्रायज: यदि आपको ACH रिटर्न मिलता है, तो समस्या बैंक-साइड या खाता-विशिष्ट है या नहीं यह निर्धारित करने के लिए राउटिंग नंबर को फिर से मान्य करें। बैंक संपर्क विवरण के साथ टिकटों को संचालन में रूट करें।
- अनुपालन और ऑडिट ट्रेल्स: भुगतान विधि बनाने या बदलने के समय मान्य बैंक का नाम, राउटिंग नंबर, और lastUpdated तिथि को स्टोर करें ताकि ऑडिटर के अनुरोधों को संतुष्ट किया जा सके।
- बैंक निर्देशिका उपकरण: वित्त और समर्थन टीमों के लिए आंतरिक लुकअप बनाएं जो एपीआई द्वारा लौटाए गए पते और फोन क्षेत्रों का उपयोग करते हैं।
अपने प्रवाह के लिए एक एंडपॉइंट कैसे चुनें
- क्या आपको संक्षिप्त रिकॉर्ड के साथ तेज़ हाँ/नहीं मान्यता की आवश्यकता है? बैंक डेटा का उपयोग करें। आप एक कॉल में सफलता, एक मान्यता संदेश, और आवश्यक बैंक विवरण प्राप्त करेंगे।
- क्या आपको ACH-विशिष्ट क्षमता, गतिविधि स्थिति, और पता क्षेत्रों का अधिक संरचित विभाजन चाहिए? paymentType=ach के साथ बैंक जानकारी प्राप्त करें।
आप उन्हें भी जोड़ सकते हैं—जैसे, कीस्ट्रोक के दौरान बैंक डेटा के साथ मान्यता करें, फिर फॉर्म सबमिट पर बैंक जानकारी के साथ ACH प्रारंभ को समृद्ध और गेट करें।
कार्यान्वयन चेकलिस्ट
- राउटिंग नंबर इनपुट को सामान्य करें: व्हाइटस्पेस और गैर-डिजिट वर्णों को हटा दें; मानक 9-अंकीय स्ट्रिंग को स्टोर करें।
- सर्वर-साइड मान्यता: केवल क्लाइंट-साइड जांच पर कभी भरोसा न करें। अपने बैकएंड से एपीआई कॉल करें।
- पुनः प्रयास और आइडेम्पोटेंसी: सीमित पुनः प्रयासों (जैसे, 1–2 प्रयासों के साथ बैकऑफ) के साथ अस्थायी नेटवर्क विफलताओं को लपेटें। 4xx मान्यता विफलताओं पर पुनः प्रयास न करें।
- कैशिंग: राउटिंग नंबर और एंडपॉइंट द्वारा कैश करें। जब उपयोगकर्ता विवरण संपादित करता है या यदि आपका कैश आपके द्वारा चुने गए बासीपन की खिड़की से अधिक हो जाता है, तो मांग पर ताज़ा करें।
- पर्यवेक्षण: राउटिंग नंबर हैश (कच्चे मूल्य नहीं), उपयोग किए गए एंडपॉइंट, और स्थिति क्षेत्रों (जैसे, सक्रिय) को लॉग करें ताकि डाउनस्ट्रीम मुद्दों को ट्रेस किया जा सके बिना PII को उजागर किए।
- डेटा मैपिंग: क्षेत्रों को लगातार मैप करें—जैसे, बैंक नाम (data.name या data.bank) और पता घटक—अपने आंतरिक स्कीमा के लिए।
- उपयोगकर्ता फीडबैक: उपयोगकर्ताओं को प्रारंभिक टाइपो पकड़ने में मदद करने के लिए UI में लौटाए गए बैंक का नाम और शहर/राज्य को प्रदर्शित करें।
AI एजेंटों द्वारा इस एपीआई को MCP के माध्यम से कॉल करना
यदि आप डेवलपर कार्यों या बैक-ऑफिस रनबुक को MCP-संगत उपकरणों (Claude Code, Cursor, Windsurf, और अन्य) के साथ स्वचालित करते हैं, तो आप Zyla के MCP गेटवे के माध्यम से राउटिंग नंबर बैंक लुकअप एपीआई को उजागर कर सकते हैं। आपका एजेंट राउटिंग नंबर जांच का अनुरोध कर सकता है और ऊपर वर्णित समान JSON फ़ील्ड प्राप्त कर सकता है, जिसे आप फिर मान्यता या संक्षेपण चरणों में फीड कर सकते हैं। सेटअप और क्लाइंट संगतता के लिए MCP दस्तावेज़ देखें:
एक बार कॉन्फ़िगर होने के बाद, प्रमाणीकरण आपके मानक Zyla बियरर टोकन के रूप में रहता है जो आपके MCP क्लाइंट के रहस्यों या पर्यावरण कॉन्फ़िगरेशन के भीतर प्रबंधित होता है।
त्रुटि प्रबंधन और फॉलबैक
एपीआई दोनों एंडपॉइंट्स के लिए संरचित JSON लौटाता है। आपके कोड में:
- गैर-2xx को परिवहन या प्रमाणीकरण त्रुटियों के रूप में मानें; उपयोगकर्ताओं को पुनः प्रयास करने या यदि समस्या बनी रहती है तो समर्थन से संपर्क करने के लिए निर्देशित करें।
- 2xx प्रतिक्रियाओं पर, शीर्ष स्तर की स्थिति/सफलता क्षेत्रों की जांच करें। यदि मान्यता विफल होती है, तो उपयोगकर्ता से राउटिंग नंबर फिर से दर्ज करने के लिए प्रेरित करें।
- वैकल्पिक क्षेत्रों की कमी के लिए गार्ड करें (जैसे, new_routing_number null हो सकता है)।
मिशन-क्रिटिकल ACH रन के लिए, यदि आपकी नीति अनुमति देती है तो अतिरिक्त जांच के साथ आगे बढ़ने के लिए एक मैनुअल ओवरराइड पथ रखें।
सुरक्षा और अनुपालन नोट्स
- अपनी एपीआई कुंजी को सुरक्षित रूप से स्टोर करें (पर्यावरण चर या एक रहस्य प्रबंधक)। कभी भी क्लाइंट-साइड कोड में हार्डकोड न करें।
- संवेदनशील पहचानकर्ताओं के हैश को कच्चे मूल्यों के बजाय लॉग करें जहाँ संभव हो।
- भुगतान विधि निर्माण/परिवर्तनों के ऑडिट का समर्थन करने के लिए टाइमस्टैम्प के साथ लौटाए गए संस्थान विवरण को बनाए रखें।
एंड-टू-एंड उदाहरण प्रवाह
- उपयोगकर्ता आपके भुगतान सेटअप फॉर्म पर राउटिंग नंबर दर्ज करता है।
- बैकएंड बैंक डेटा का उपयोग करके मान्यता करता है। यदि success=false, तो एक स्पष्ट त्रुटि संदेश लौटाएँ।
- यदि मान्य है, तो बैकएंड ACH क्षमता और सक्रिय स्थिति की पुष्टि करने के लिए बैंक जानकारी प्राप्त करें (paymentType=ach)।
- बैकएंड स्टोर करता है: routingNumber, बैंक का नाम, पता घटक, फोन, सक्रिय, lastUpdated।
- UI पुष्टि के लिए: बैंक का नाम और शहर/राज्य प्रदर्शित करता है।
- अपने सामान्य सुरक्षित चैनल का उपयोग करके खाता संख्या और खाता प्रकार एकत्र करने के लिए आगे बढ़ें।
संदर्भ: एंडपॉइंट विवरण
बैंक जानकारी प्राप्त करें
- विधि: GET
- यूआरएल: https://zylalabs.com/api/331/routing-number-bank-lookup-api/266/get-bank-information
- आवश्यक पैरामीटर: routingnumber, paymentType
- लौटाता है: नाम, ACH राउटिंग नंबर, शाखा प्रकार, पता घटक, फोन, सक्रिय ध्वज, lastUpdated
बैंक डेटा
- विधि: GET
- यूआरएल: https://zylalabs.com/api/331/routing-number-bank-lookup-api/1353/bank-data
- आवश्यक पैरामीटर: संख्या
- लौटाता है: मान्यता स्थिति/संदेश, बैंक का नाम, पता, फोन, date_of_revision, new_routing_number
इस एकीकरण के लिए Zyla का उपयोग क्यों करें
- आपके स्टैक में सभी एपीआई के लिए एक खाता और एक प्रमाणीकरण हेडर।
- सदस्यता + कोटा मॉडल जो इंजीनियरिंग शेड्यूल के लिए पे-पर-कॉल बिलिंग की तुलना में बेहतर है।
- जब आपको आवश्यकता हो तो आसन्न वित्तीय उपयोगिताएँ जोड़ें—Zyla API हब पर श्रेणियों में खोजने योग्य।
अक्सर पूछे जाने वाले प्रश्न
प्रश्न: मैं प्रमाणीकरण के लिए कौन सा हेडर उपयोग करूँ?
उत्तर: हर अनुरोध के साथ Authorization: Bearer YOUR_API_KEY भेजें।
प्रश्न: मुझे कैसे पता चलेगा कि एक राउटिंग नंबर ACH का समर्थन करता है?
उत्तर: paymentType=ach के साथ बैंक जानकारी प्राप्त करें। आगे बढ़ने का निर्णय लेने के लिए data.active और संबंधित क्षेत्रों की जांच करें।
प्रश्न: क्या मैं एक ही कॉल के साथ राउटिंग नंबर को मान्य कर सकता हूँ?
उत्तर: हाँ, बैंक डेटा एंडपॉइंट सफलता और मान्यता संदेश के साथ प्रदान किए गए नंबर के लिए बैंक विवरण लौटाता है।
प्रश्न: मुझे क्या कैश करना चाहिए?
उत्तर: विलंबता और कॉल को कम करने के लिए राउटिंग नंबर के अनुसार प्रतिक्रियाओं को कैश करें। ताज़ा करने की आवृत्ति निर्धारित करने के लिए lastUpdated (जब उपलब्ध हो) और अपनी जोखिम नीति का उपयोग करें।
प्रश्न: क्या कोई मुफ्त योजना है?
उत्तर: मॉडल सदस्यता + कोटा है। यहाँ पहला एपीआई 7-दिन की परीक्षण अवधि या 50 अनुरोध प्रदान करता है; वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए एपीआई के पृष्ठ की जांच करें।
राउटिंग नंबर मान्यता और बैंक समृद्धि भेजने के लिए तैयार हैं? सदस्यता लें और लिस्टिंग पर अपनी एपीआई कुंजी प्राप्त करें: राउटिंग नंबर बैंक लुकअप एपीआई पर 7-दिन का परीक्षण शुरू करें। एक बार सदस्यता लेने के बाद, आप Zyla पर अन्य वित्तीय एपीआई के साथ उसी कुंजी का पुन: उपयोग कर सकते हैं।