API to check card

आपको एक भुगतान कार्ड को तेजी से मान्य करने की आवश्यकता है, आदर्श रूप से इसे चार्ज करने या लेनदेन को रूट करने से पहले। इस गाइड के अंत तक, आपके पास एक कार्यशील कॉल होगा जो एक कार्ड का BIN (पहले 6 अंक) की जांच करता है और ब्रांड, प्रकार, स्तर, जारीकर्ता और देश को एकल Finance API का उपयोग करके लौटाता है जो Zyla API Hub पर है—आज ही अपने एकीकरण में पेस्ट करने के लिए तैयार।

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

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

अधिकृत करने से पहले असमर्थित कार्ड ब्रांड या प्रकार को अस्वीकार करें।
जारीकर्ता के देश के आधार पर लेनदेन को सही प्रोसेसर पर रूट करें।
ग्राहक सहायता या अनुपालन जांच के लिए जारीकर्ता की जानकारी पूर्व-भरें।
BIN को वैधता की जांच करके धोखाधड़ी की जांच को बढ़ाएं।

Zyla API Hub हजारों Finance & Payments APIs को एक खाते, एक API कुंजी, और एक सदस्यता मॉडल के तहत केंद्रीकृत करता है। आप अपने डेवलपर डैशबोर्ड से सेवाओं के बीच अपने एक्सेस और उपयोग का प्रबंधन कर सकते हैं zylalabs.com पर।

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

जल्दी एकीकृत करने के लिए:

Zyla पर कार्ड चेकिंग API पृष्ठ खोलें: कार्ड चेकिंग API पर 7-दिन का परीक्षण शुरू करें.
सदस्यता लें (या जब उपलब्ध हो तो मुफ्त परीक्षण शुरू करें)। इस API के लिए, पहली API 7-दिन का परीक्षण या 50 अनुरोध प्रदान करती है।
अपने डैशबोर्ड से अपनी API कुंजी कॉपी करें। प्रमाणीकरण HTTP हेडर के माध्यम से है: Authorization: Bearer YOUR_API_KEY.

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

आप जो एंडपॉइंट कॉल करेंगे

कार्ड चेकिंग API एक सरल एंडपॉइंट प्रदान करती है जो एक BIN को मान्य करती है और कार्ड विवरण लौटाती है। सभी अनुरोध GET हैं और आपके बियरर टोकन के साथ प्रमाणित हैं।

कार्ड चेक करें

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

यह क्या करता है: प्रदान किए गए BIN को मान्य करता है और एक JSON पेलोड लौटाता है जिसमें मान्यता स्थिति और कार्ड मेटाडेटा (ब्रांड, प्रकार, स्तर, जारीकर्ता, और देश) शामिल होते हैं।

cURL जिसे आप पेस्ट कर सकते हैं और चला सकते हैं

YOUR_API_KEY को अपनी Zyla डैशबोर्ड से कुंजी के साथ बदलें और इसे अपने टर्मिनल में चलाएं:

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

आधिकारिक उदाहरण प्रतिक्रिया

{
"status": 200,
"success": true,
"isValid": true,
"message": "BIN संख्या मान्य है।",
"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"
}
}

क्षेत्र जिन्हें आप आमतौर पर उपयोग करेंगे:

status: पेलोड में लौटाए गए HTTP-जैसे स्थिति कोड (200 सफलता को इंगित करता है)।
success: API ऑपरेशन के लिए बूलियन सफलता संकेतक।
isValid: क्या BIN को मान्य के रूप में पहचाना गया है।
message: एक मानव-पठनीय मान्यता परिणाम।
data.bin_iin: API द्वारा लौटाया गया मानकीकृत BIN/IIN।
data.card_brand: कार्ड नेटवर्क (जैसे, MASTERCARD, VISA, आदि)।
data.card_type: CREDIT/DEBIT (रूटिंग या शुल्क गणनाओं के लिए उपयोगी)।
data.card_level: जैसे, GOLD, PLATINUM (कभी-कभी लाभ लॉजिक के लिए उपयोग किया जाता है)।
data.issuer_name_bank: जारीकर्ता बैंक का नाम।
data.issuer_bank_phone: जारीकर्ता फोन (सहायता कार्यप्रवाह के लिए)।
data.iso_country_name / data.iso_country_code: जारीकर्ता देश (जैसे, TR तुर्की के लिए)।

Python उदाहरण: एक BIN को मान्य करें और शाखा लॉजिक

यह उदाहरण उसी एंडपॉइंट को कॉल करता है और केवल MASTERCARD क्रेडिट कार्ड को एक विशिष्ट देश में जारी करने की अनुमति देने के लिए प्रतिक्रिया क्षेत्रों का उपयोग करता है। अपनी आवश्यकताओं के अनुसार लॉजिक को समायोजित करें।

import os
import requests

API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
BIN = "444444" # कार्ड के पहले 6 अंक

url = "https://zylalabs.com/api/2333/card-checker-api/2243/check-card"
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()

if not data.get("success"):
raise RuntimeError(f"कार्ड जांच विफल: {data}")

if not data.get("isValid"):
print("BIN मान्य नहीं है। ब्लॉक करें या वापस जाएं।")
else:
meta = data.get("data", {})
brand = meta.get("card_brand")
ctype = meta.get("card_type")
country = meta.get("iso_country_code")
issuer = meta.get("issuer_name_bank")

print(f"BIN मान्य। ब्रांड={brand}, प्रकार={ctype}, जारीकर्ता={issuer}, देश={country}")

# उदाहरण नीति: केवल TR से MASTERCARD क्रेडिट कार्ड स्वीकार करें
if brand == "MASTERCARD" and ctype == "CREDIT" and country == "TR":
print("प्राधिकरण प्रवाह के साथ आगे बढ़ें।")
else:
print("व्यवसाय नियमों के आधार पर अलग तरीके से रूट करें या अस्वीकार करें।")

व्यावहारिक एकीकरण नोट्स जो समय बचाते हैं

BIN लंबाई: केवल पहले 6 अंक आवश्यक हैं (एंडपॉइंट एक 6-अंक की संख्या की अपेक्षा करता है)।
कब कॉल करें: कार्ड अंकों को एकत्र करने के बाद जितनी जल्दी हो सके जांच चलाएं, अपने PSP को अधिकृत करने से पहले।
कैशिंग: BIN-से-मेटाडेटा मैपिंग्स कम ही बदलती हैं। सफल प्रतिक्रियाओं को कैश करें (जैसे, 24 घंटे से 7 दिन) ताकि विलंबता और कोटा उपयोग को कम किया जा सके, और BIN द्वारा अमान्य करें।
गोपनीयता: आप कभी भी इस API को पूर्ण PAN नहीं भेजते—केवल BIN। यह आपकी सेवा में संवेदनशील डेटा हैंडलिंग के दायरे को कम करता है।
टाइमआउट और पुनः प्रयास: एक उचित क्लाइंट टाइमआउट का उपयोग करें (जैसे, 5–10s)। अस्थायी नेटवर्क मुद्दों के लिए, एकल पुनः प्रयास आमतौर पर पर्याप्त होता है इससे पहले कि डिफ़ॉल्ट प्रवाह पर वापस लौटें।
कोटा: यह API सदस्यता + कोटा मॉडल पर चलती है (पे-पर-कॉल नहीं)। अपने Zyla डैशबोर्ड में अपने उपयोग की निगरानी करें और योजना सीमाओं के भीतर रहने के लिए बैच या कैश करें।
विफलता हैंडलिंग: यदि सफलता गलत है या अनुरोध विफल होता है, तो यह तय करें कि सर्वोत्तम प्रयास प्राधिकरण की अनुमति दी जाए या समर्थित नेटवर्क/प्रकार की आवश्यकता हो। ऑडिट के लिए पेलोड को लॉग करें।
ऑडिटिंग: BIN और प्रतिक्रिया डेटा क्षेत्रों को बनाए रखें जिन पर आप भरोसा करते हैं (ब्रांड, प्रकार, जारीकर्ता, देश) आपके भुगतान प्रयास रिकॉर्ड के साथ ट्रेसबिलिटी के लिए।

एंड-टू-एंड प्रवाह उदाहरण

ग्राहक आपके चेकआउट फॉर्म पर कार्ड नंबर दर्ज करता है।
आपका फ्रंटएंड पहले छह अंकों (BIN) को निकालता है और इसे TLS के माध्यम से आपके बैकएंड को भेजता है।
आपका बैकएंड उस BIN के साथ कार्ड चेकिंग API को कॉल करता है।
यदि isValid सही है, तो प्रोसेसर रूट चुनने के लिए card_brand, card_type, और iso_country_code का उपयोग करें या नीति लागू करें (जैसे, केवल CREDIT की अनुमति है)।
BIN परिणाम को कैश करें। प्राधिकरण या 3DS प्रवाह के साथ आगे बढ़ें।

उपयोग के मामले जिन्हें आप इस सप्ताह भेज सकते हैं

कार्ड स्वीकृति गेटिंग: डाउनस्ट्रीम में गेटवे अस्वीकृतियों को कम करने के लिए असमर्थित ब्रांड या प्रकार को जल्दी ब्लॉक करें।
भौगोलिक-आधारित रूटिंग: iso_country_code का उपयोग करके जारीकर्ता के देश के लिए अनुकूलित प्रोसेसर को लेनदेन भेजें।
शुल्क गणना: अपने मूल्य निर्धारण लॉजिक में card_type या card_level (जैसे, GOLD/PLATINUM) के आधार पर शुल्क भिन्न करें।
सहायता उपकरण: एजेंटों को तेजी से वृद्धि करने के लिए issuer_name_bank और फोन दिखाएं।
जोखिम नियम: BIN वैधता को डिवाइस, IP, और वेग की जांच के साथ मिलाएं ताकि घर्षण को बढ़ाएं या घटाएं।

AI एजेंटों से Zyla MCP एंडपॉइंट के साथ काम करना

यदि आप AI कोडिंग वातावरण या एजेंटों (जैसे, Claude Code, Cursor, Windsurf) का उपयोग करते हैं, तो आप MCP ब्रिज के माध्यम से Zyla APIs को कॉल कर सकते हैं। अपने क्लाइंट को Zyla MCP एंडपॉइंट से कनेक्ट करने के लिए कॉन्फ़िगर करें और अपनी API कुंजी प्रदान करें। यहाँ और जानें: MCP. वहां से, एजेंट बिन पैरामीटर और आपके बियरर टोकन के तहत उसी चेक कार्ड एंडपॉइंट को लागू कर सकता है।

यह आपको प्रॉम्प्ट्स को प्रोटोटाइप करने की अनुमति देता है जैसे “BIN 444444 को मान्य करें और मुझे जारीकर्ता का देश बताएं” और परिणाम को सीधे आपके कोड जनरेशन या रनबुक में वायर करें—बिना अपने IDE को छोड़े।

परीक्षण चेकलिस्ट

हैप्पी पथ: एक ज्ञात मान्य BIN सफलता=true और isValid=true के साथ पूर्ण डेटा क्षेत्रों को लौटाता है।
अमान्य इनपुट: गैर-संख्यात्मक या गलत-लंबाई इनपुट को अस्वीकार कर दिया जाता है या isValid=false लौटाता है (आपके UI में सुचारू रूप से संभालें)।
नीति शाखा: पुष्टि करें कि आपके ब्रांड/प्रकार/देश के नियम स्वीकृति और रूटिंग परिणामों में सही ढंग से परिलक्षित होते हैं।
कैशिंग: सुनिश्चित करें कि एक ही BIN के लिए दोहराई गई जांच कैश हिट करती है और आउटबाउंड कॉल को कम करती है।
पर्यवेक्षण: स्थिति, isValid, और प्रमुख डेटा क्षेत्रों को लॉग करें; कैश हिट दर और API त्रुटियों के लिए मैट्रिक्स जोड़ें।

संदर्भ: एंडपॉइंट सारांश

कार्ड चेक करें (GET): https://zylalabs.com/api/2333/card-checker-api/2243/check-card
- आवश्यक पैरामीटर: bin (संख्या)
- प्रमाणन: Authorization: Bearer YOUR_API_KEY
- लौटाता है: स्थिति, सफलता, isValid, संदेश, और BIN/IIN मेटाडेटा (ब्रांड, प्रकार, स्तर, जारीकर्ता, देश) के साथ डेटा

Finance एकीकरण के लिए Zyla API Hub क्यों

10,000 से अधिक सार्वजनिक APIs एक खाते और एक कुंजी के तहत सुलभ होने के साथ, Zyla कई एकीकरण भेजने वाली टीमों के लिए ओवरहेड को कम करता है। आप कार्ड चेकिंग API की सदस्यता ले सकते हैं और जैसे-जैसे आपका स्टैक विकसित होता है, इसे अन्य Finance & Payments उपकरणों के साथ लेयर कर सकते हैं, सभी आपके Zyla डैशबोर्ड पर zylalabs.com पर।

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

क्या मैं एक पूर्ण PAN को मान्य कर सकता हूँ या केवल BIN?
यह एंडपॉइंट केवल 6-अंक के BIN को मान्य करता है। पूर्ण PAN न भेजें। PAN-स्तरीय मान्यता और प्राधिकरण के लिए अपने भुगतान गेटवे का उपयोग करें।

मैं प्रमाणीकरण के लिए कौन सा हेडर उपयोग करूँ?
हर अनुरोध के साथ Authorization: Bearer YOUR_API_KEY भेजें।

यदि BIN मान्य नहीं है तो क्या होगा?
प्रतिक्रिया isValid को गलत के रूप में इंगित करेगी (और यदि कॉल निष्पादित किया गया है तो सफलता अभी भी सही हो सकती है)। उस संकेत का उपयोग करें ताकि आप अपने प्रवाह को समायोजित कर सकें, जैसे कि कार्ड को ब्लॉक करना या वैकल्पिक भुगतान विधि का अनुरोध करना।

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

क्या मैं इस API को AI एजेंट से कॉल कर सकता हूँ?
हाँ। अपने एजेंट को Zyla MCP एंडपॉइंट से कनेक्ट करें और अपनी API कुंजी के साथ प्रमाणित करें। एजेंट bin पैरामीटर के साथ चेक कार्ड एंडपॉइंट को लागू कर सकता है।

अपने एकीकरण को भेजें

BINs को मान्य करें, लेनदेन को स्मार्ट तरीके से रूट करें, और एक कॉल के साथ रोकने योग्य अस्वीकृतियों को कम करें। यहाँ से शुरू करें और अपनी कुंजी प्राप्त करें: कार्ड चेकिंग API पर 7-दिन का परीक्षण शुरू करें. एक बार सदस्यता लेने के बाद, अपने बियरर टोकन के साथ ऊपर दिए गए GET एंडपॉइंट का उपयोग करें और इस सप्ताह अपने Finance कार्यप्रवाह को भेजें।