API for BIN checker

आपको इस सप्ताह कार्ड BINs को मान्य करने की आवश्यकता है ताकि आपकी चेकआउट, KYC, या जोखिम इंजन यह तय कर सके कि लेनदेन को कैसे रूट, फ्लैग, या समृद्ध किया जाए। इस लेख के अंत तक, आप एक उत्पादन-तैयार वित्त API को 6-अंकीय BIN को सत्यापित करने के लिए कॉल करेंगे और कार्ड ब्रांड, प्रकार, और जारीकर्ता मेटाडेटा को पढ़ेंगे जिसे आप सीधे अपने प्रवाह में प्लग कर सकते हैं।

यह API क्या लौटाता है और डेवलपर्स इसका उपयोग क्यों करते हैं

क्रेडिट कार्ड वेलिडेटर - BIN चेकर्स API Zyla API Hub पर एक भुगतान कार्ड के बारे में विवरण लौटाता है जो इसके BIN (पहले 6 अंक) के आधार पर है। आप पुष्टि कर सकते हैं कि BIN मान्य है या नहीं और कार्ड_brand, कार्ड_type, कार्ड_level, जारीकर्ता मेटाडेटा, और ISO देश के फ़ील्ड सहित फ़ील्ड पढ़ सकते हैं।

विशिष्ट वित्त उपयोग के मामले:

• चेकआउट प्रवाह: UX को अनुकूलित करने के लिए प्रारंभ में कार्ड ब्रांड और प्रकार निर्धारित करें (जैसे, ब्रांड लोगो प्रदर्शित करें, फ़ील्ड मास्क समायोजित करें)।
• धोखाधड़ी/जोखिम: जारीकर्ता देश या असमर्थित प्रकार के आधार पर लेनदेन को ब्लॉक या समीक्षा करें।
• रूटिंग: ब्रांड या प्रकार के आधार पर एक अधिग्रहक या भुगतान रेल चुनें।
• विश्लेषण: रिपोर्टिंग के लिए ब्रांड/प्रकार के अनुसार लेनदेन को विभाजित करें।

आप इस API को Zyla API Hub के माध्यम से एक्सेस करेंगे, जो 10,000 से अधिक सार्वजनिक APIs के लिए एकल खाता और कुंजी प्रदान करता है। मार्केटप्लेस में प्रमाणीकरण समान है, जो आपकी एकीकरण और रखरखाव को सरल बनाता है।

Zyla API Hub पर शुरुआत करना

वित्त श्रेणी API के लिए मार्केटप्लेस लिस्टिंग खोलें जिसका हम यहां उपयोग कर रहे हैं और सदस्यता लें। आपको सदस्यता और कोटा (पे-पर-कॉल नहीं) के माध्यम से उपयोग मिलता है। आप जो पहला API कनेक्ट करते हैं वह 7-दिन की परीक्षण अवधि या 50 अनुरोधों के साथ शुरू हो सकता है; वर्तमान एक्सेस विकल्पों के लिए आइटम पृष्ठ की जांच करें।

• API पृष्ठ पर जाएं: क्रेडिट कार्ड वेलिडेटर - BIN चेकर्स API पर 7-दिन की परीक्षण अवधि शुरू करें
• जब उपलब्ध हो, तो सदस्यता लें या मुफ्त परीक्षण शुरू करें, फिर अपनी API कुंजी प्राप्त करें।
• हर अनुरोध पर Authorization: Bearer YOUR_API_KEY हेडर के साथ अपनी कुंजी का उपयोग करें।

आप Zyla API Hub पर अधिक वित्त APIs और अन्य श्रेणियों को ब्राउज़ कर सकते हैं, और मार्केटप्लेस में एक ही कुंजी और सदस्यता मॉडल का पुन: उपयोग कर सकते हैं।

एंडपॉइंट संदर्भ और cURL त्वरित प्रारंभ

नीचे वह एकल एंडपॉइंट है जिसकी आपको BIN मान्यता और समृद्धि के लिए आवश्यकता है। केवल स्पष्ट रूप से सूचीबद्ध पैरामीटर यहां समर्थित हैं; अन्य जोड़ने का प्रयास न करें।

• एंडपॉइंट: BIN चेकर्स
• विधि: GET
• अनुरोध URL: https://zylalabs.com/api/40/credit-card-validator-bin-checker-api/1885/bin-checker
• आवश्यक क्वेरी पैरामीटर:
  • bin (string): 6-अंकीय बैंक पहचान संख्या

प्रमाणीकरण:

• हेडर: Authorization: Bearer YOUR_API_KEY

आधिकारिक cURL नमूना (अपने सेटअप को सत्यापित करने के लिए कॉपी/पेस्ट करें):

curl -s -X GET "https://zylalabs.com/api/40/credit-card-validator-bin-checker-api/1885/bin-checker?bin=346350" \
-H "Authorization: Bearer YOUR_API_KEY"

आधिकारिक JSON प्रतिक्रिया (फील्ड जिन्हें आप पार्स करेंगे, उन्हें नीचे ठीक उसी तरह दिखाया गया है जैसे लौटाया गया):

{
"status": 200,
"success": true,
"isValid": true,
"message": "The BIN number is valid.",
"data": {
"bin_iin": "346350",
"card_brand": "AMERICAN EXPRESS",
"card_type": "CREDIT",
"card_level": "------",
"issuer_name_bank": "------",
"issuer_bank_website": "API Only",
"issuer_bank_phone": "API Only",
"iso_country_name": null,
"iso_country_code": null
}
}

फील्ड नोट्स जिन्हें आप संभवतः उपभोग करेंगे:

• isValid: अज्ञात/अमान्य BINs के लिए स्वीकार करने या शाखा तर्क के लिए बूलियन गेट।
• data.card_brand: ब्रांड द्वारा प्रदर्शित या रूट करें (जैसे, AMERICAN EXPRESS)।
• data.card_type: क्रेडिट या डेबिट हैंडलिंग में भिन्नताएँ (जैसे, अधिभार नियम, रूटिंग)।
• data.bin_iin: इनपुट BIN का इको (लॉगिंग और विश्लेषण के लिए)।
• जारीकर्ता और ISO फ़ील्ड: वैकल्पिक समृद्धि; स्ट्रिंग या नल के रूप में उपस्थित।

AI एजेंटों द्वारा MCP के माध्यम से कॉल करना

यदि आप एक संगत IDE या क्लाइंट में AI एजेंट के साथ कॉल को समन्वयित करना पसंद करते हैं, तो Zyla अपने MCP एंडपॉइंट के माध्यम से मार्केटप्लेस APIs को उजागर करता है। अपने MCP-संगत क्लाइंट को कॉन्फ़िगर करें और इसे MCP पर इंगित करें। MCP एंडपॉइंट के लिए apikey क्वेरी पैरामीटर के साथ अपनी Zyla API कुंजी का उपयोग करें (यानी, apikey=YOUR_API_KEY)। अपने टूल के अनुरोध में, उसी BIN चेकर्स GET URL को लक्षित करें और ऊपर दिखाए गए अनुसार bin क्वेरी स्ट्रिंग पास करें। प्रतिक्रिया बॉडी और फ़ील्ड सीधे HTTP कॉल के समान रहती हैं।

Python उदाहरण: एक BIN को मान्य करें और अपने प्रवाह को शाखाबद्ध करें

यह न्यूनतम Python स्निपेट ऊपर दिए गए सटीक एंडपॉइंट को कॉल करता है, isValid पढ़ता है, फिर card_brand और card_type पर शाखाबद्ध होता है। इसे तुरंत उपयोग के लिए CLI टूल या बैकएंड सेवा में कॉपी-पेस्ट करने के लिए लिखा गया है।

import os
import requests

API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
URL = "https://zylalabs.com/api/40/credit-card-validator-bin-checker-api/1885/bin-checker"
params = {"bin": "346350"}
headers = {"Authorization": f"Bearer {API_KEY}"}

resp = requests.get(URL, params=params, headers=headers, timeout=15)
resp.raise_for_status()
data = resp.json()

# त्वरित जांच
if not data.get("success"):
raise RuntimeError(f"अनुरोध सफल नहीं हुआ: {data}")

if not data.get("isValid"):
print("अमान्य या अज्ञात BIN। फॉलबैक लागू करें या ब्लॉक करें।")
else:
info = data.get("data", {})
brand = info.get("card_brand")
ctype = info.get("card_type")
issuer = info.get("issuer_name_bank")
iso_code = info.get("iso_country_code")

# उदाहरण रूटिंग तर्क
if brand == "AMERICAN EXPRESS":
print("AMEX-संगत अधिग्रहक के लिए रूट करें।")
elif brand in ("VISA", "MASTERCARD"):
print("मुख्यधारा अधिग्रहक A के लिए रूट करें।")
else:
print("डिफ़ॉल्ट अधिग्रहक B का उपयोग करें।")

# उदाहरण अनुपालन/जोखिम जांच
if ctype == "CREDIT":
print("यदि लागू हो तो क्रेडिट-कार्ड अधिभार तर्क लागू करें।")
if iso_code is None:
print("जारीकर्ता देश अज्ञात; अतिरिक्त जांच पर विचार करें.")

# लॉग या एक संरचित घटना उत्पन्न करें
result = {
"bin": info.get("bin_iin"),
"brand": brand,
"type": ctype,
"issuer": issuer,
"iso_country_code": iso_code,
}
print("BIN लुकअप परिणाम:", result)

उत्पादन के लिए नोट्स:

• टाइमआउट: नेटवर्क परिवर्तनशीलता के लिए 10–20 सेकंड उचित है; अपने SLO के अनुसार समायोजित करें।
• कैशिंग: BIN डेटा अपेक्षाकृत स्थिर है; विलंबता और कॉल को कम करने के लिए घंटों या दिनों के लिए 6-अंकीय BIN द्वारा कैश करें।
• पुनः प्रयास: अस्थायी HTTP त्रुटियों पर बैकऑफ के साथ idempotent पुनः प्रयास लागू करें।
• PII: एक BIN PAN-स्तरीय PII नहीं है, लेकिन फिर भी लॉग को सावधानी से संभालें; कभी भी पूर्ण कार्ड नंबर लॉग न करें।

आप परीक्षण और पार्स कर सकते हैं प्रतिक्रिया उदाहरण

नीचे सभी उदाहरण आधिकारिक प्रतिक्रिया आकार को प्रदर्शित करते हैं। आप अपने पार्सिंग तर्क में इन फ़ील्ड नामों पर भरोसा कर सकते हैं।

उदाहरण A

{
"status": 200,
"success": true,
"isValid": true,
"message": "The BIN number is valid.",
"data": {
"bin_iin": "346350",
"card_brand": "AMERICAN EXPRESS",
"card_type": "CREDIT",
"card_level": "------",
"issuer_name_bank": "------",
"issuer_bank_website": "API Only",
"issuer_bank_phone": "API Only",
"iso_country_name": null,
"iso_country_code": null
}
}

उदाहरण B (समान संरचना; सुनिश्चित करें कि आपकी JSON पार्सिंग नल के लिए मजबूत है)

{
"status": 200,
"success": true,
"isValid": true,
"message": "The BIN number is valid.",
"data": {
"bin_iin": "346350",
"card_brand": "AMERICAN EXPRESS",
"card_type": "CREDIT",
"card_level": "------",
"issuer_name_bank": "------",
"issuer_bank_website": "API Only",
"issuer_bank_phone": "API Only",
"iso_country_name": null,
"iso_country_code": null
}
}

उदाहरण C (फील्ड नामों और प्रकारों को पिन करने के लिए यूनिट परीक्षण में उपयोग करें)

{
"status": 200,
"success": true,
"isValid": true,
"message": "The BIN number is valid.",
"data": {
"bin_iin": "346350",
"card_brand": "AMERICAN EXPRESS",
"card_type": "CREDIT",
"card_level": "------",
"issuer_name_bank": "------",
"issuer_bank_website": "API Only",
"issuer_bank_phone": "API Only",
"iso_country_name": null,
"iso_country_code": null
}
}

उदाहरण D (स्कीमा-केंद्रित: डेटा में ड्रिल करने से पहले शीर्ष-स्तरीय ध्वज पढ़ें)

{
"status": 200,
"success": true,
"isValid": true,
"message": "The BIN number is valid.",
"data": {
"bin_iin": "346350",
"card_brand": "AMERICAN EXPRESS",
"card_type": "CREDIT",
"card_level": "------",
"issuer_name_bank": "------",
"issuer_bank_website": "API Only",
"issuer_bank_phone": "API Only",
"iso_country_name": null,
"iso_country_code": null
}
}

वित्त में व्यावहारिक कार्यान्वयन

BIN चेकर्स को मुख्य भुगतान कार्यप्रवाह में प्लग करें ताकि अस्वीकृतियों को कम किया जा सके और निर्णय लेने में सुधार किया जा सके:

• चेकआउट UX: जब एक उपयोगकर्ता 6वां अंक टाइप करता है, तो कार्ड_brand निर्धारित करने के लिए एंडपॉइंट पर हिट करें और AMERICAN EXPRESS बनाम अन्य के लिए प्रासंगिक लोगो प्रदर्शित करें या इनपुट मास्क अपडेट करें।
• जोखिम फ़िल्टर: यदि isValid गलत है, तो अपने प्रोसेसर को सबमिट करने से पहले एक वैकल्पिक विधि को ब्लॉक या अनुरोध करें।
• रूटिंग रणनीतियाँ: कार्ड_type == CREDIT के लिए, अनुकूल इंटरचेंज ऑप्टिमाइजेशन के साथ एक अधिग्रहक को भेजें; DEBIT (जब लागू हो) के लिए, अलग तरीके से रूट करें या यदि आपके स्टैक के लिए प्रासंगिक हो तो PIN विकल्पों के लिए संकेत दें।
• अनुपालन: भौगोलिक प्रतिबंधों या अतिरिक्त स्टेप-अप सत्यापन को सूचित करने के लिए iso_country_code पढ़ें जहां जारीकर्ता क्षेत्र महत्वपूर्ण है।
• ग्राहक सहायता उपकरण: अपने आंतरिक आदेश दर्शक में BIN मेटाडेटा दिखाएं ताकि एजेंट जल्दी से कार्ड संदर्भ को समझ सकें।

समय बचाने वाले इंजीनियरिंग विवरण:

• जब आपके पास ठीक 6 अंक हों तभी API को कॉल करें। हर कीस्ट्रोक पर कॉल न करें।
• BIN कुंजी पर कैश करें; प्रति-उपयोगकर्ता डुप्लिकेशन से बचें। यहां तक कि एक साधारण LRU कैश भी विलंबता और उपयोग को नाटकीय रूप से कम कर सकता है।
• ऑपरेटर डैशबोर्ड के लिए संदेश सतह करें। यह मानव-हितैषी है और डिबगिंग में मदद करता है।
• स्थिति और सफलता फ़ील्ड को लॉग करें। वे परिवहन मुद्दों को डोमेन मान्यता से अलग करने के लिए उपयोगी हैं।
• विशेषता ध्वज समन्वयित करें ताकि आप अपने जोखिम के दृष्टिकोण के अनुसार BIN सेवा अनुपलब्ध होने पर खुला या बंद विफल हो सकें।

क्या आपको अधिक वित्तीय निर्माण ब्लॉक की आवश्यकता है? Zyla API Hub पर अतिरिक्त श्रेणियों और लिस्टिंग का अन्वेषण करें और एक ही मार्केटप्लेस कुंजी का पुन: उपयोग करें।

FAQ

न्यूनतम इनपुट क्या आवश्यक है?
आपको BIN चेकर्स GET एंडपॉइंट पर bin क्वेरी पैरामीटर का उपयोग करके 6-अंकीय BIN प्रदान करना होगा।

मैं प्रमाणीकरण कैसे करूँ?
आपको Zyla API Hub एंडपॉइंट पर भेजे गए हर अनुरोध पर Authorization: Bearer YOUR_API_KEY हेडर शामिल करना होगा।

क्या मूल्य निर्धारण पे-पर-कॉल है?
नहीं। Zyla APIs सदस्यता के साथ कोटा का उपयोग करती हैं। वर्तमान एक्सेस विकल्पों और मूल्य निर्धारण के लिए मार्केटप्लेस आइटम पृष्ठ की जांच करें।

क्या कोई मुफ्त योजना है?
कोई मुफ्त योजना नहीं है। आपके पहले API के लिए, आप उपलब्ध होने पर 7-दिन की परीक्षण अवधि या 50 अनुरोधों के साथ शुरू कर सकते हैं; विवरण के लिए लिस्टिंग देखें।

क्या मैं इसे किसी एजेंट या IDE सहायक से कॉल कर सकता हूँ?
हाँ। अपनी कुंजी के साथ Zyla के MCP एकीकरण का उपयोग करें। अपने MCP-संगत क्लाइंट को उसी BIN चेकर्स एंडपॉइंट तक पहुंचने के लिए कॉन्फ़िगर करें और ऊपर दिखाए अनुसार bin पास करें।

क्या आप उत्पादन में BINs को मान्य करने के लिए तैयार हैं? मार्केटप्लेस पर सदस्यता लें और अभी अपनी एकीकरण शुरू करें: क्रेडिट कार्ड वेलिडेटर - BIN चेकर्स API पर 7-दिन की परीक्षण अवधि शुरू करें।