आपके चेकआउट, केवाईसी प्रवाह, या जोखिम प्रणाली में क्रेडिट कार्ड डेटा प्रवाहित हो रहा है, और आपको बीआईएन (पहले 6 अंक) को मान्य करने और ब्रांड, प्रकार, और जारीकर्ता मेटाडेटा की पहचान करने के लिए एक तेज़ तरीका चाहिए—इस सप्ताह, अगले तिमाही में नहीं। इस लेख के अंत तक, आप बीआईएन को मान्य करने और क्रेडिट कार्ड वेलिडेटर - बीआईएन चेकर्स एपीआई का उपयोग करके कार्ड ब्रांड, प्रकार, और जारीकर्ता जानकारी प्राप्त करने में सक्षम होंगे—कॉपी-पेस्ट cURL और पायथन के साथ।
यह एपीआई क्या करता है और यह क्यों महत्वपूर्ण है
क्रेडिट कार्ड वेलिडेटर - बीआईएन चेकर्स एपीआई एक दिए गए बीआईएन (कार्ड नंबर के पहले 6 अंक) के लिए मेटाडेटा लौटाता है। एकल GET अनुरोध के साथ, आप जानेंगे कि बीआईएन मान्य है या नहीं और डेटा प्राप्त करेंगे जैसे:
- कार्ड ब्रांड (जैसे, AMERICAN EXPRESS)
- कार्ड प्रकार (जैसे, CREDIT)
- कार्ड स्तर जब उपलब्ध हो
- जारीकर्ता डेटा (जब उपलब्ध हो)
- देश की जानकारी (जब उपलब्ध हो)
टीमें बीआईएन जांच का उपयोग इनपुट को पूर्व-मान्य करने, कार्ड ब्रांड यूआई तत्वों को स्वचालित रूप से चुनने, अतिरिक्त धोखाधड़ी नियम लागू करने, और भुगतान को रूट करने के लिए करती हैं। चूंकि अनुरोध केवल पहले 6 अंकों का उपयोग करता है, यह पूर्ण पीएएन भेजने की तुलना में पीसीआई दायरे को कम करता है।
यह एपीआई Zyla API Hub पर वित्त और भुगतान श्रेणी का हिस्सा है, जो एक खाते, एक एपीआई कुंजी, और एक सदस्यता मॉडल के तहत 10,000 से अधिक सार्वजनिक एपीआई का एक मार्केटप्लेस है। आप एक स्थान पर अपने उपयोग का प्रबंधन कर सकते हैं और जैसे-जैसे आपका स्टैक बढ़ता है, कई एपीआई को कॉल कर सकते हैं।
Zyla API Hub पर शुरुआत करना
क्रेडिट कार्ड वेलिडेटर - बीआईएन चेकर्स एपीआई का प्रयास करने के लिए:
- एपीआई लिस्टिंग खोलें: क्रेडिट कार्ड वेलिडेटर - बीआईएन चेकर्स एपीआई पर 7-दिन का परीक्षण शुरू करें.
- सदस्यता लें या मुफ्त परीक्षण शुरू करें (जब उपलब्ध हो)। यह एपीआई आमतौर पर आपको जल्दी से निर्माण और परीक्षण करने में मदद करने के लिए 7-दिन का परीक्षण समर्थन करता है। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए एपीआई पृष्ठ की जांच करें।
- अपने डैशबोर्ड से अपनी एपीआई कुंजी कॉपी करें।
सभी अनुरोध एक Bearer टोकन का उपयोग करते हैं जो Authorization हेडर में होता है। बिलिंग सदस्यता + कोटा है (पे-पर-कॉल नहीं)। कोई मुफ्त योजना नहीं है; मूल्यांकन के लिए परीक्षण का उपयोग करें। अपनी कुंजी को सुरक्षित रखें; इसे सार्वजनिक फ्रंट-एंड कोड में न embed करें।
एंडपॉइंट अवलोकन
यह एपीआई बीआईएन मान्यता और मेटाडेटा के लिए एक GET एंडपॉइंट को उजागर करता है:
- विधि: GET
- यूआरएल: https://zylalabs.com/api/40/credit-card-validator-bin-checker-api/1885/bin-checker
- क्वेरी पैरामीटर:
- bin (स्ट्रिंग, आवश्यक): कार्ड के पहले 6 अंक (बीआईएन/आईआईएन)। उदाहरण: 346350
- प्रमाणन: Authorization: Bearer YOUR_API_KEY
उच्च-स्तरीय व्यवहार: आप एक बीआईएन भेजते हैं, और एपीआई एक स्थिति कोड, एक सफलता ध्वज, एक बूलियन isValid फ़ील्ड, एक संदेश, और कार्ड मेटाडेटा को समाहित करने वाले डेटा ऑब्जेक्ट के साथ प्रतिक्रिया करता है। यदि कुछ विशेषताएँ अनुपलब्ध हैं, तो प्रतिक्रिया उस पर प्लेसहोल्डर या नल के साथ परिलक्षित होगी।
cURL जिसे आप कॉपी/पेस्ट कर सकते हैं
यहां लाइव एंडपॉइंट के खिलाफ एक पूर्ण, कार्यशील उदाहरण है। Zyla API Hub से अपनी कुंजी के साथ YOUR_API_KEY को बदलें:
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"
आधिकारिक उदाहरण प्रतिक्रिया
यह 346350 बीआईएन को क्वेरी करते समय एंडपॉइंट द्वारा लौटाई गई आधिकारिक नमूना पेलोड है:
{
"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
}
}
आप जिन फ़ील्ड नोट्स का उपयोग करेंगे:
- status: सेवा द्वारा लौटाया गया संख्यात्मक HTTP-जैसा स्थिति कोड।
- success: इंगित करता है कि अनुरोध को सफलतापूर्वक संसाधित किया गया था।
- isValid: यदि बीआईएन मौजूद है और पहचाना गया है तो सत्य।
- message: मानव-पठनीय मान्यता सारांश।
- data: कार्ड मेटाडेटा, जहां कोई भी गायब या प्रतिबंधित जानकारी प्लेसहोल्डर या नल के रूप में लौटाई जा सकती है।
पायथन उदाहरण: एंडपॉइंट को कॉल करना और फ़ील्ड को पार्स करना
यह स्क्रिप्ट एक बीआईएन भेजती है, वैधता की जांच करती है, और रूटिंग या डिस्प्ले लॉजिक के लिए चयनित विशेषताओं को प्रिंट करती है।
import os
import requests
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
BIN = "346350"
url = "https://zylalabs.com/api/40/credit-card-validator-bin-checker-api/1885/bin-checker"
params = {"bin": BIN}
headers = {
"Authorization": f"Bearer {API_KEY}"
}
resp = requests.get(url, params=params, headers=headers, timeout=10)
resp.raise_for_status()
data = resp.json()
# Basic sanity checks
if not data.get("success"):
raise RuntimeError(f"API reported failure: {data}")
# Use isValid to decide next steps
if data.get("isValid"):
meta = data.get("data", {})
brand = meta.get("card_brand")
type = meta.get("card_type")
level = meta.get("card_level")
issuer = meta.get("issuer_name_bank")
country = meta.get("iso_country_name")
print(f"BIN {BIN} is valid.")
print(f"- Brand: {brand}")
print(f"- Type: {type}")
print(f"- Level: {level}")
print(f"- Issuer: {issuer}")
print(f"- Country: {country}")
else:
print(f"BIN {BIN} is not valid. Message: {data.get('message')}")
अतिरिक्त प्रतिक्रिया उदाहरण जिन्हें आप परीक्षण कर सकते हैं
जब आप एकीकृत करते हैं, तो अपने पार्सर में 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
}
}
स्टोरेज के लिए उदाहरण (जैसे, Redis/DB रिकॉर्ड)
{
"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
}
}
डाउनस्ट्रीम समृद्धि सेवाओं के लिए उदाहरण
{
"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
}
}
अपने भुगतान या जोखिम प्रवाह में इसे कैसे वायर करें
वास्तविक पैटर्न जो डेवलपर्स उत्पादन में भेजते हैं:
- क्लाइंट-साइड यूएक्स सहायता: जैसे ही एक उपयोगकर्ता पहले 6 अंक दर्ज करता है, बीआईएन को अपने बैक एंड पर भेजें, एपीआई को कॉल करें, और पता लगाए गए ब्रांड (जैसे, AMERICAN EXPRESS) को प्रदर्शित करें ताकि कीिंग त्रुटियों को कम किया जा सके। एपीआई कुंजी को सर्वर-साइड रखें।
- रूटिंग नियम: लेनदेन को निर्देशित करने या जोखिम थ्रेशोल्ड लागू करने के लिए card_type का उपयोग करें। उदाहरण के लिए, डाउनस्ट्रीम स्कोरिंग लॉजिक में CREDIT को DEBIT से अलग तरीके से संभालें।
- केवाईसी/धोखाधड़ी गेट: यदि isValid गलत है, तो प्रयास को अवरुद्ध करें या आगे बढ़ने से पहले स्टेप-अप सत्यापन की आवश्यकता करें।
- जारीकर्ता नियंत्रण: यदि जारीकर्ता डेटा उपलब्ध है, तो बैंक या देश द्वारा व्यावसायिक नियम लागू करें। रक्षात्मक रहें: जारीकर्ता फ़ील्ड प्रतिबंधित या नल हो सकते हैं।
- कैशिंग: हाल के बीआईएन लुकअप को घंटों या दिनों के लिए कैश करें (आपकी जोखिम सहिष्णुता के आधार पर) ताकि विलंबता और कोटा उपयोग को कम किया जा सके। बीआईएन मेटाडेटा कम बार बदलता है, लेकिन हमेशा ताज़ा लॉजिक की अनुमति दें।
मान्यता, सुरक्षा, और पीसीआई विचार
इस एंडपॉइंट पर केवल बीआईएन (पहले 6 अंक) भेजें। अपने लॉग में पूर्ण पीएएन को न भेजें या न रखें। लॉग से Authorization हेडर को भी बाहर रखें। एक छोटा सर्वर-साइड एडेप्टर बनाएं जो आपके क्लाइंट से बीआईएन स्वीकार करता है, इस एपीआई को कॉल करता है, और केवल वही लौटाता है जो आपको रेंडर करने के लिए चाहिए। यदि आप परिणामों को स्टोर करते हैं, तो केवल वही मेटाडेटा स्टोर करें जिसकी आपको आवश्यकता है और नल या प्लेसहोल्डर मानों को साफ करें।
आपको किस व्यवहार के चारों ओर डिज़ाइन करना चाहिए
- प्रतिबंधित फ़ील्ड: कुछ जारीकर्ता फ़ील्ड "एपीआई केवल" या मास्क किए जा सकते हैं। गैर-खाली जारीकर्ता नाम/वेबसाइट/फोन मानने की कोशिश न करें।
- नल हैंडलिंग: देश के फ़ील्ड नल हो सकते हैं; सुनिश्चित करें कि आपका कोड बिना फेंके सहिष्णुता रखता है।
- संदेश और स्थिति: उपयोगकर्ता-फेसिंग संदेश या लॉग बनाने के लिए isValid और स्थिति दोनों का उपयोग करें।
- पुनः प्रयास और समय समाप्त: उचित समय समाप्त सेट करें (जैसे, 5–10 सेकंड) और केवल नेटवर्क समय समाप्त पर पुनः प्रयास करें, 4xx मान्यता परिणामों पर नहीं।
- Idempotence: बीआईएन जांच केवल पढ़ने के लिए हैं; आप बैकऑफ के साथ नेटवर्क विफलताओं को सुरक्षित रूप से पुनः प्रयास कर सकते हैं।
एंड-टू-एंड उदाहरण: मिडलवेयर पैटर्न
यहां एक व्यावहारिक प्रवाह है जिसे आप दोहरा सकते हैं:
- फ्रंटेंड पहले 6 अंक (जैसे, 346350) को HTTPS के माध्यम से अपने सर्वर पर भेजता है।
- आपका सर्वर Authorization: Bearer YOUR_API_KEY के साथ बीआईएन चेकर्स एंडपॉइंट को कॉल करता है।
- यदि सफलता और isValid सत्य हैं, तो UI को "AMERICAN EXPRESS · CREDIT" को दर्शाने के लिए ब्रांड और प्रकार के साथ क्लाइंट को प्रतिक्रिया दें।
- यदि मान्य नहीं है, तो उपयोगकर्ता को किसी भी कार्ड सबमिशन चरण की अनुमति देने से पहले इनपुट को सत्यापित करने के लिए प्रेरित करें।
- वैकल्पिक रूप से, दोहराए गए प्रविष्टियों पर राउंड-ट्रिप को कम करने के लिए बीआईएन द्वारा एक छोटे TTL के लिए कैश करें।
टिपिकल चेकआउट यूआई के लिए फ़ील्ड-द्वारा-फ़ील्ड मैपिंग
- ब्रांड बैज: data.card_brand का उपयोग करें (जैसे, "AMERICAN EXPRESS").
- कार्ड प्रकार संकेत: data.card_type का उपयोग करें (जैसे, "CREDIT").
- जारीकर्ता लेबल: यदि यह प्लेसहोल्डर नहीं है तो data.issuer_name_bank का उपयोग करें; अन्यथा छोड़ दें।
- देश का ध्वज या पाठ: जब उपलब्ध हो तो data.iso_country_name का उपयोग करें।
रेंडरिंग से पहले हमेशा प्लेसहोल्डर (जैसे, "------") या नल के खिलाफ सुरक्षा करें।
परीक्षण चेकलिस्ट
- एक ज्ञात बीआईएन भेजें और सत्यापित करें कि isValid बूलियन है।
- सुनिश्चित करें कि data.bin_iin की उपस्थिति क्वेरी किए गए बीआईएन से मेल खाती है।
- ब्रांड और प्रकार फ़ील्ड को स्ट्रिंग और सुरक्षित रूप से रेंडर करने के लिए सत्यापित करें।
- सुनिश्चित करें कि नल या प्लेसहोल्डर मान आपकी यूआई या जोखिम इंजन को तोड़ते नहीं हैं।
- सुनिश्चित करें कि सभी कॉल में Authorization हेडर मौजूद है और कभी लॉग नहीं किया गया।
MCP के माध्यम से एआई एजेंटों के साथ काम करना
यदि आप एआई कोडिंग टूल (जैसे, Claude Code, Cursor, Windsurf) के साथ वर्कफ़्लोज़ को स्वचालित करते हैं, तो आप मॉडल संदर्भ प्रोटोकॉल (MCP) के माध्यम से Zyla APIs को कॉल कर सकते हैं। अपने MCP-संगत क्लाइंट को Zyla MCP एंडपॉइंट का उपयोग करने के लिए कॉन्फ़िगर करें और अपनी एपीआई कुंजी प्रदान करें। यहां एकीकरण विवरण देखें: MCP. यह एक एजेंट को एक ही बीआईएन चेक वर्कफ़्लो को ट्रिगर करने की अनुमति देता है, जबकि आपका सर्वर कुंजी भंडारण और लॉगिंग को नियंत्रित करता है। प्रॉम्प्ट को न्यूनतम रखें और भुगतान प्रवाह में कार्य करने से पहले आउटपुट को मान्य करें।
ऑपरेशनल टिप्स
- निगरानी: प्रत्येक अनुरोध के लिए सफलता, स्थिति, और विलंबता को ट्रैक करें। विफलताओं में स्पाइक्स पर अलर्ट करें।
- थ्रॉटलिंग: एक अच्छे एपीआई नागरिक बनने के लिए क्लाइंट-साइड दर सीमित करें और गुणात्मक बैकऑफ लागू करें।
- संस्करण नियंत्रण: विक्रेता प्रतिक्रियाएँ विकसित हो सकती हैं; अपने पार्सर को ज्ञात फ़ील्ड पर पिन करें और अप्रत्याशित अतिरिक्त को अनदेखा करें।
- डेटा जीवनचक्र: कैश किए गए बीआईएन परिणामों पर स्पष्ट TTL सेट करें और कार्ड-हैंडलिंग लॉजिक में महत्वपूर्ण परिवर्तनों पर फिर से मान्य करें।
पर्यावरणों के बीच नमूना प्रतिक्रिया का पुन: उपयोग
CI, स्थानीय विकास, और स्टेजिंग के लिए, नीचे दिए गए आधिकारिक नमूना पेलोड का उपयोग करें ताकि आप अपने मैपर और यूआई का परीक्षण कर सकें बिना वास्तविक कार्ड डेटा को लीक किए। आकार के लिए एक ही सत्य का स्रोत रखें।
{
"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
}
}
उत्पादन तत्परता चेकलिस्ट
- पर्यावरण चर: अपने रहस्यों के प्रबंधक में YOUR_API_KEY को स्टोर करें।
- नेटवर्क नीतियाँ: एंडपॉइंट यूआरएल के लिए zylalabs.com पर आउटबाउंड HTTPS की अनुमति दें।
- समय-बाउंड पुनः प्रयास: केवल नेटवर्क त्रुटियों पर पुनः प्रयास करें; मान्यता विफलताओं पर पुनः प्रयास न करें।
- पर्यवेक्षण: ऑडिट के लिए अनुरोध आईडी और स्ट्रिप की गई प्रतिक्रियाओं (बिना रहस्यों के) को लॉग करें।
- एक्सेस नियंत्रण: बीआईएन चेकर्स को कॉल करने वाली सेवाओं को सीमित करें ताकि पार्श्व जोखिम को कम किया जा सके।
सामान्य pitfalls और उनसे कैसे बचें
- प्रदर्शित कुंजी के साथ क्लाइंट-साइड कॉल: हमेशा अपने सर्वर के माध्यम से प्रॉक्सी करें।
- यह मान लेना कि जारीकर्ता या देश हमेशा मौजूद है: प्लेसहोल्डर और नल को सुचारू रूप से संभालें।
- संदेश पाठ को केवल पार्स करना: लॉजिक के लिए isValid और स्थिति का उपयोग करें; संदेश मानवों के लिए है।
- पुराना कैश: उचित TTL सेट करें और यदि आप असंगत मेटाडेटा का पता लगाते हैं तो अमान्य करें।
अगला कहाँ जाएं
अन्य वित्त और भुगतान एपीआई ब्राउज़ करें और Zyla API Hub पर एक खाते के तहत अपने एकीकरणों को समेकित करें। अपनी जोखिम, भुगतान, और रिपोर्टिंग उपयोग के मामलों को एक पारिस्थितिकी तंत्र में एकल एपीआई कुंजी और सदस्यता के साथ रखें।
अक्सर पूछे जाने वाले प्रश्न
क्या एपीआई पूर्ण कार्ड नंबरों को मान्य करता है?
नहीं। एंडपॉइंट एक बीआईएन (पहले 6 अंक) को मान्य करता है और संबंधित मेटाडेटा लौटाता है। पूर्ण पीएएन न भेजें।
कौन सी प्रमाणीकरण आवश्यक है?
प्रत्येक अनुरोध के हेडर में Authorization: Bearer YOUR_API_KEY भेजें।
क्या कोई मुफ्त योजना है?
कोई मुफ्त योजना नहीं है। वर्तमान पहुंच के लिए एपीआई लिस्टिंग की जांच करें। सेवा का मूल्यांकन करने के लिए आमतौर पर 7-दिन का परीक्षण उपलब्ध है।
मुझे बीआईएन परिणामों को कितनी बार कैश करना चाहिए?
बीआईएन मेटाडेटा कम बार बदलता है। अपनी जोखिम स्थिति और ताज़ा अनुसूची के अनुसार कैश करें। हमेशा ताज़ा होने पर नल/प्लेसहोल्डर्स को संभालें।
मैं इसे एआई एजेंट से कैसे कॉल करूं?
एक MCP-संगत क्लाइंट का उपयोग करें और इसे Zyla MCP एंडपॉइंट पर इंगित करें जो यहां दस्तावेजित है: MCP. कुंजी को एक सुरक्षित स्टोर में रखें और कार्य करने से पहले आउटपुट को मान्य करें।
बीआईएन मान्यता भेजने के लिए तैयार हैं? अपने मूल्यांकन को शुरू करें और मार्केटप्लेस पर एक एपीआई कुंजी प्राप्त करें: क्रेडिट कार्ड वेलिडेटर - बीआईएन चेकर्स एपीआई पर 7-दिन का परीक्षण शुरू करें.