Zyla API हब पर कार्ड चेक करने वाला API: curl और JSON के साथ पहला अनुरोध

आपको चेकआउट प्रवाह को भेजने, असमर्थित कार्डों को ब्लॉक करने या लेनदेन को रूट करने से पहले एक भुगतान कार्ड का BIN/IIN सत्यापित करना होगा। इस गाइड के अंत तक, आप Zyla API हब पर कार्ड चेक करने वाले API के लिए एक कार्यशील GET अनुरोध करेंगे, प्रतिक्रिया को पार्स करेंगे, और इसे curl, Python, या JavaScript का उपयोग करके अपनी सेवा में वायर करेंगे—इस सप्ताह तैनात करने के लिए तैयार।

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

कार्ड चेक करने वाला API एक BIN/IIN (कार्ड नंबर के पहले 6 अंक) को मान्य करता है और कार्ड के बारे में संरचित मेटाडेटा लौटाता है, जिसमें ब्रांड, प्रकार, स्तर, जारीकर्ता, जारीकर्ता संपर्क विवरण, और देश शामिल हैं। सामान्य उपयोग में शामिल हैं:

Illustration: Card Checker API on Zyla API Hub: First Request with curl and JSON

चेकआउट पर ब्रांड और जारीकर्ता को तुरंत दिखाने के लिए BIN को पूर्व-मान्य करना।
अधिकृत करने से पहले सर्वर-साइड पर असमर्थित ब्रांडों या देशों को ब्लॉक करना।
रूटिंग लॉजिक: उदाहरण के लिए, TR में जारी किए गए MASTERCARD CREDIT GOLD को एक विशिष्ट प्रोसेसर पर भेजें।
विश्लेषण: बिना पूर्ण PAN को संभाले जारीकर्ता या देश द्वारा रूपांतरण को विभाजित करना।

सभी कॉल Zyla API Hub के माध्यम से चलती हैं, इसलिए आप एक खाता, एक API कुंजी, और APIs के बीच एकल सदस्यता मॉडल का उपयोग करते हैं।

Zyla API Hub पर शुरू करना

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

Authorization: Bearer YOUR_API_KEY

यदि आपके पास अभी तक खाता नहीं है, तो यहां एक बनाएं: पंजीकरण करें।

एंडपॉइंट अवलोकन

कार्ड चेक करने वाला API एकल एंडपॉइंट को उजागर करता है जो एक BIN को मान्य करता है और कार्ड और जारीकर्ता विवरण लौटाता है।

नाम: कार्ड चेक करें
विधि: GET
URL: https://zylalabs.com/api/2333/card-checker-api/2243/check-card
आवश्यक क्वेरी पैरामीटर:
- bin (संख्या): कार्ड के पहले 6 अंक। उदाहरण: 444444

उच्च-स्तरीय व्यवहार: आप एक 6-अंक का BIN प्रदान करते हैं और एक मान्यता बूलियन, संदेश, और ब्रांड, प्रकार, स्तर, जारीकर्ता, जारीकर्ता संपर्क जानकारी, और ISO देश के साथ एक डेटा ऑब्जेक्ट प्राप्त करते हैं।

curl के साथ पहला अनुरोध

आधिकारिक उदाहरण के साथ अपना पहला कॉल करें। Zyla से अपने टोकन के साथ YOUR_API_KEY को बदलें।

curl -s -X GET "https://zylalabs.com/api/2333/card-checker-api/2243/check-card?bin=444444" \
-H "Authorization: Bearer YOUR_API_KEY"

आधिकारिक नमूना JSON प्रतिक्रिया:

{
"status": 200,
"success": true,
"isValid": true,
"message": "The BIN number is valid.",
"data": {
"bin_iin": "557829",
"card_brand": "MASTERCARD",
"card_type": "CREDIT",
"card_level": "GOLD",
"issuer_name_bank": "AKBANK T.A.S.",
"issuer_bank_website": "------",
"issuer_bank_phone": "4442525",
"iso_country_name": "TURKEY",
"iso_country_code": "TR"
}
}

मुख्य फ़ील्ड जिन्हें आप उपयोग करेंगे:

isValid: Boolean जो इंगित करता है कि BIN को मान्य के रूप में पहचाना गया है या नहीं।
card_brand, card_type, card_level: UI और रूटिंग लॉजिक के लिए कार्ड वर्गीकरण।
issuer_name_bank, issuer_bank_phone, issuer_bank_website: समर्थन कार्यप्रवाह या अनुपालन जांच के लिए जारीकर्ता मेटाडेटा।
iso_country_name, iso_country_code: भू-आधारित लॉजिक के लिए देश (ISO अल्फा-2 कोड)।

Python उदाहरण: ब्रांड पर मान्य करें और शाखा बनाएं

नीचे दिया गया स्निपेट उसी एंडपॉइंट को कॉल करता है और एक विशिष्ट ब्रांड और देश के लिए लॉजिक को शाखित करता है। यह केवल प्रलेखित पैरामीटर और हेडर का उपयोग करता है।

import os
import requests

API_KEY = os.environ.get("ZYLALABS_API_KEY", "YOUR_API_KEY")
URL = "https://zylalabs.com/api/2333/card-checker-api/2243/check-card"
params = {"bin": 444444}
headers = {"Authorization": f"Bearer {API_KEY}"}

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

if data.get("success") and data.get("isValid") and data.get("data"):
details = data["data"]
brand = details.get("card_brand")
type = details.get("card_type")
level = details.get("card_level")
country = details.get("iso_country_code")

print(f"Brand={brand}, Type={type}, Level={level}, Country={country}")

# उदाहरण रूटिंग स्थिति
if brand == "MASTERCARD" and type == "CREDIT" and country == "TR":
print("Route to processor: TR-MC-CREDIT")
else:
print("Route to default processor")
else:
print("BIN not valid or lookup unsuccessful")

स्थानीय रूप से परीक्षण करने के लिए, ZYLALABS_API_KEY को निर्यात करें और स्क्रिप्ट चलाएं। टाइमआउट, पुनः प्रयास, और लॉगिंग आपके वातावरण पर छोड़ दिए गए हैं।

JavaScript उदाहरण: एज या नोड रनटाइम

यह उदाहरण fetch का उपयोग करके उसी एंडपॉइंट को कॉल करता है और चेकआउट UI के लिए व्यावहारिक फ़ील्ड पढ़ता है।

const API_KEY = process.env.ZYLALABS_API_KEY || "YOUR_API_KEY";
const url = "https://zylalabs.com/api/2333/card-checker-api/2243/check-card?bin=444444";

async function checkBin() {
const res = await fetch(url, {
method: "GET",
headers: { "Authorization": `Bearer ${API_KEY}` }
});
if (!res.ok) {
throw new Error(`HTTP ${res.status}`);
}
const json = await res.json();

if (json.success && json.isValid && json.data) {
const {
card_brand,
card_type,
card_level,
issuer_name_bank,
iso_country_code
} = json.data;

console.log(`Brand: ${card_brand}, Type: ${card_type}, Level: ${card_level}`);
console.log(`Issuer: ${issuer_name_bank}, Country: ${iso_country_code}`);
} else {
console.log("Invalid BIN or lookup failed");
}
}

checkBin().catch(err => {
console.error("Request failed:", err);
});

सर्वरलेस, एज, या बैकग्राउंड जॉब्स में समान कोड का उपयोग करें। API कुंजी को सर्वर साइड पर रखें और कभी भी इसे ब्राउज़रों में उजागर न करें।

स्थानीय परीक्षण के लिए आप जो नमूना प्रतिक्रियाएँ संग्रहीत कर सकते हैं

UI प्रवाह और यूनिट परीक्षण बनाते समय, कुछ फिक्स्चर फ़ाइलों को आधिकारिक नमूना प्रतिक्रिया के साथ रखें ताकि आप कोटा को हिट किए बिना पुनरावृत्ति कर सकें। यहां आधिकारिक नमूना JSON फिर से है:

{
"status": 200,
"success": true,
"isValid": true,
"message": "The BIN number is valid.",
"data": {
"bin_iin": "557829",
"card_brand": "MASTERCARD",
"card_type": "CREDIT",
"card_level": "GOLD",
"issuer_name_bank": "AKBANK T.A.S.",
"issuer_bank_website": "------",
"issuer_bank_phone": "4442525",
"iso_country_name": "TURKEY",
"iso_country_code": "TR"
}
}

आप विभिन्न फ़ाइल नामों (जैसे, sample_valid_1.json, sample_valid_2.json) के तहत समान JSON को भी डुप्लिकेट कर सकते हैं ताकि सेवाओं के बीच पार्सर पथों का लगातार अभ्यास किया जा सके।

{
"status": 200,
"success": true,
"isValid": true,
"message": "The BIN number is valid.",
"data": {
"bin_iin": "557829",
"card_brand": "MASTERCARD",
"card_type": "CREDIT",
"card_level": "GOLD",
"issuer_name_bank": "AKBANK T.A.S.",
"issuer_bank_website": "------",
"issuer_bank_phone": "4442525",
"iso_country_name": "TURKEY",
"iso_country_code": "TR"
}
}

एंड-टू-एंड परीक्षण के लिए, समान फिक्स्चर को लोड करें और यह सुनिश्चित करें कि आपका अनुप्रयोग ब्रांड/प्रकार/स्तर को अपेक्षित UX या रूटिंग विकल्प से मैप करता है।

{
"status": 200,
"success": true,
"isValid": true,
"message": "The BIN number is valid.",
"data": {
"bin_iin": "557829",
"card_brand": "MASTERCARD",
"card_type": "CREDIT",
"card_level": "GOLD",
"issuer_name_bank": "AKBANK T.A.S.",
"issuer_bank_website": "------",
"issuer_bank_phone": "4442525",
"iso_country_name": "TURKEY",
"iso_country_code": "TR"
}
}

समय बचाने के लिए कार्यान्वयन विवरण

पैरामीटर मान्यता: सर्वर-साइड पर bin पैरामीटर के लिए सख्ती से 6 अंकों की संख्या स्वीकार करें। API को कॉल करने से पहले कुछ और अस्वीकार करें।
कैशिंग: BIN मेटाडेटा उपयोगकर्ता-विशिष्ट नहीं है। अपने डेटा स्टोर या एज कैश में BIN द्वारा सफल प्रतिक्रियाओं को कैश करें ताकि राउंड ट्रिप को कम किया जा सके।
टाइमआउट और पुनः प्रयास: अपने HTTP क्लाइंट में एक स्पष्ट टाइमआउट सेट करें। अपने वातावरण में केवल सुरक्षित-से-पुनः प्रयास श्रेणियों पर बैकऑफ के साथ संवेदनशील पुनः प्रयासों का उपयोग करें।
PCI दायरा: आप केवल एक BIN (पहले 6 अंक) भेजते हैं, पूर्ण PAN नहीं। कॉल को सर्वर-साइड रखें और API कुंजी या संवेदनशील हेडर को लॉग करने से बचें।
अंतर्राष्ट्रीयकरण: UI बैज, धोखाधड़ी नियमों, या रूटिंग नीतियों को स्थानीयकृत करने के लिए iso_country_code का उपयोग करें।
विश्लेषण: रूपांतरण, अस्वीकृतियों, और चार्जबैक को समूहित करने के लिए {card_brand, card_type, card_level, iso_country_code} को बनाए रखें।

प्रतिक्रिया को अनुप्रयोग लॉजिक से मैप करना

यहां एक सीधा मैपिंग पैटर्न है जिसे आप अपने स्टैक के लिए अनुकूलित कर सकते हैं:

BIN प्रविष्टि (पहले 6 अंक) पर, bin के साथ एंडपॉइंट पर एक सर्वर-साइड कॉल करें।
यदि isValid और success दोनों सत्य हैं:
- card_brand का उपयोग करके ब्रांड आइकन दिखाएं (जैसे, MASTERCARD)।
- card_type और iso_country_code का उपयोग करके प्रोसेसिंग रूट का चयन करें।
- यदि आपके सिस्टम में लागू हो, तो देश-विशिष्ट 3DS या SCA नियम सक्षम करें।
यदि मान्यता विफल होती है (जैसे, न तो success या न ही isValid), तो सामान्य UX के साथ आगे बढ़ें या एक गैर-ब्लॉकिंग संकेत प्रदर्शित करें।

सहायता लॉग या विवाद कार्यप्रवाह के लिए issuer_name_bank को उपलब्ध रखें।

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

यदि आप MCP-संगत क्लाइंट (Claude Code, Cursor, Windsurf, आदि) के साथ विकास कार्यों का आयोजन करते हैं, तो आप MCP एंडपॉइंट के माध्यम से Zyla APIs को भी सक्रिय कर सकते हैं। अपने Zyla API कुंजी को अपने क्लाइंट द्वारा निर्दिष्ट के अनुसार प्रदान करें और कॉल करें:

MCP बेस: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY

MCP दस्तावेज़ की समीक्षा करें और अपने क्लाइंट को कनेक्ट करें ताकि आपका एजेंट कार्ड चेक करने वाले API एंडपॉइंट पर वही GET अनुरोध कर सके और JSON को आपके कार्यक्षेत्र में वापस कर सके। यहां और जानें: MCP।

संचालन नोट्स

कोटा और परीक्षण: Zyla सदस्यता + कोटा का उपयोग करता है। आपके पहले API के लिए, आपको आमतौर पर 7-दिन का परीक्षण या 50 अनुरोध मिलते हैं। कोई मुफ्त योजना नहीं है। कार्ड चेक करने वाले API पृष्ठ पर वर्तमान विवरण की जांच करें।
सुरक्षा: प्राधिकरण हेडर को सर्वर-साइड पर रखें। यदि उजागर हो तो अपनी कुंजी को घुमाएं।
पर्यवेक्षण: अपने सिस्टम में अनुरोध आईडी लॉग करें। API कुंजी को छिपाएं और किसी भी आंतरिक लॉग में पूर्ण PAN को स्टोर करने से बचें।
सुचारू कमी: यदि आपके वातावरण में लुकअप अस्थायी रूप से अनुपलब्ध है, तो सामान्य कॉपी के साथ चेकआउट को आगे बढ़ने की अनुमति दें (अस्थायी मेटाडेटा लुकअप पर वैध उपयोगकर्ताओं को न रोकें)।

अनौपचारिक JSON पर एक और नज़र अनुबंध स्पष्टता के लिए

टीम हैंडऑफ और अनुबंध-प्रथम एकीकरण के लिए, फ़ील्ड नामों और नेस्टिंग को स्पष्ट करने के लिए अपने दस्तावेज़ में आधिकारिक नमूना रखें:

{
"status": 200,
"success": true,
"isValid": true,
"message": "The BIN number is valid.",
"data": {
"bin_iin": "557829",
"card_brand": "MASTERCARD",
"card_type": "CREDIT",
"card_level": "GOLD",
"issuer_name_bank": "AKBANK T.A.S.",
"issuer_bank_website": "------",
"issuer_bank_phone": "4442525",
"iso_country_name": "TURKEY",
"iso_country_code": "TR"
}
}

इन सटीक कुंजियों का उपयोग अपने सीरियलाइज़र्स, DTOs, या TypeScript प्रकारों में करें ताकि सेवाओं के बीच असंगतियों से बचा जा सके।

समस्या निवारण चेकलिस्ट

आपके वातावरण में 401/403 त्रुटियाँ: सुनिश्चित करें कि प्राधिकरण हेडर मौजूद है और कुंजी आपके Zyla खाते के तहत सक्रिय है।
आपके पार्सर में अप्रत्याशित JSON आकार: फिर से जांचें कि आप प्रलेखित एंडपॉइंट URL को कॉल कर रहे हैं और केवल bin पैरामीटर पास कर रहे हैं।
BIN जो मान्य लगते हैं लेकिन आपके UI में isValid नहीं लौटाते हैं: सत्यापित करें कि आप ठीक 6 अंक भेज रहे हैं और संख्यात्मक पार्सिंग के दौरान अग्रणी शून्य नहीं हटा रहे हैं।
सर्वरलेस में अस्थायी नेटवर्क त्रुटियाँ: टाइमआउट को थोड़ा बढ़ाएं और एक पुनः प्रयास जोड़ें; पिछले सफल लुकअप को कैश करें।

अगला कहाँ जाना है

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

अक्सर पूछे जाने वाले प्रश्न

BIN चेक के लिए सटीक URL और विधि क्या है?
GET https://zylalabs.com/api/2333/card-checker-api/2243/check-card bin क्वेरी पैरामीटर और Authorization: Bearer YOUR_API_KEY के साथ।

कौन से पैरामीटर आवश्यक हैं?
bin (संख्या, 6 अंक)। उदाहरण: 444444। इस एंडपॉइंट के लिए कोई अन्य पैरामीटर आवश्यक नहीं हैं।

मुझे प्रतिक्रिया से कौन से फ़ील्ड का उपभोग करना चाहिए?
पहले success और isValid की जांच करें। फिर data.card_brand, data.card_type, data.card_level, data.issuer_name_bank, data.iso_country_code (और यदि आप इसे प्रदर्शित करते हैं तो iso_country_name) पढ़ें।

बिलिंग कैसे संभाली जाती है?
Zyla सदस्यता + कोटा (पे-पर-कॉल नहीं) का उपयोग करता है। आपके पहले API के लिए, आपको आमतौर पर 7-दिन का परीक्षण या 50 अनुरोध मिलते हैं। कोई मुफ्त योजना नहीं है। वर्तमान विवरण के लिए API पृष्ठ देखें।

क्या मैं इसे AI कोडिंग एजेंटों से कॉल कर सकता हूँ?
हाँ, Zyla के MCP एंडपॉइंट के माध्यम से https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY। अपने MCP-संगत क्लाइंट को कॉन्फ़िगर करें ताकि वही GET कॉल जारी की जा सके और JSON वापस किया जा सके।

क्या आप अपने एकीकरण को भेजने के लिए तैयार हैं? अपना खाता बनाएं, कार्ड चेक करने वाले API की सदस्यता लें, और यहां अपनी कुंजी प्राप्त करें: पंजीकरण करें। फिर अपने पहले BIN को सत्यापित करने और प्रतिक्रिया को अपने चेकआउट या रूटिंग लॉजिक में वायर करने के लिए ऊपर दिए गए curl कमांड का उपयोग करें।