कार्ड चेकर्स API के साथ काम करना

आपको इस सप्ताह कार्ड BINs को मान्य और समृद्ध करना है ताकि आप जोखिम भरे भुगतानों को चिह्नित कर सकें, लेनदेन को सही ढंग से मार्गदर्शित कर सकें, या अपने वित्तीय स्टैक में जारीकर्ता डेटा को पूर्व-भर सकें। इस गाइड के अंत तक, आप Zyla API Hub पर कार्ड चेकर्स API के लिए प्रमाणित अनुरोध करेंगे, उत्तर को विश्वसनीय रूप से व्याख्या करेंगे, और इसे एक उत्पादन चेकआउट या जोखिम कार्यप्रवाह में वायर करेंगे।

कार्ड चेकर्स API क्या करता है

कार्ड चेकर्स API एक कार्ड के BIN (बैंक पहचान संख्या, कार्ड नंबर के पहले 6 अंक) की पुष्टि करता है और जारीकर्ता और नेटवर्क विवरण लौटाता है। एकल GET कॉल के साथ, आप जानेंगे कि BIN मान्य है या नहीं और कार्ड ब्रांड, प्रकार, स्तर, जारीकर्ता का नाम, जारीकर्ता का फोन, और ISO देश की जानकारी सहित संरचित फ़ील्ड प्राप्त करेंगे। टीमें इसका उपयोग करती हैं:

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

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

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

1. API सूची खोलें और सदस्यता लें: कार्ड चेकर्स API पर 7-दिन की परीक्षण अवधि शुरू करें.
2. अपनी API कुंजी कॉपी करें।
3. नीचे दस्तावेज़ किए गए एंडपॉइंट पर हर अनुरोध पर Authorization: Bearer YOUR_API_KEY का उपयोग करें।

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

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

विधि: GET

URL: https://zylalabs.com/api/2333/card-checker-api/2243/check-card

विवरण: 6-अंक के BIN को मान्य करता है और जारीकर्ता और नेटवर्क मेटाडेटा लौटाता है।

आवश्यक क्वेरी पैरामीटर:

• bin (संख्या): 6-अंक का BIN। उदाहरण: 444444

cURL उदाहरण (कॉपी/पेस्ट)

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"
}
}

आप इस पेलोड से सामान्यतः क्या उपयोग करेंगे:

• isValid: Boolean ध्वज जो इंगित करता है कि BIN मान्यता प्राप्त और मान्य है।
• data.bin_iin: लुकअप के लिए लौटाया गया BIN/IIN (स्ट्रिंग)।
• data.card_brand: नेटवर्क/ब्रांड (जैसे, MASTERCARD)।
• data.card_type: कार्ड उत्पाद श्रेणी (जैसे, CREDIT)।
• data.card_level: स्तर/टियर (जैसे, GOLD) यदि उपलब्ध हो।
• data.issuer_name_bank: जारीकर्ता बैंक का नाम।
• data.issuer_bank_phone: जारीकर्ता संपर्क फोन।
• data.iso_country_name / iso_country_code: जारीकर्ता देश (नाम और ISO अल्फा-2 कोड)।

Python उदाहरण

यह नमूना एंडपॉइंट को कॉल करता है, वैधता की जांच करता है, और फ़ील्ड प्रिंट करता है जिन्हें आप चेकआउट नियमों या जोखिम स्कोरिंग के लिए उपयोग कर सकते हैं। YOUR_API_KEY को अपनी कुंजी से बदलें।

import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://zylalabs.com/api/2333/card-checker-api/2243/check-card"

def fetch_bin_info(bin_number: str) -> dict:
headers = {
"Authorization": f"Bearer {API_KEY}"
}
params = {
"bin": bin_number
}
resp = requests.get(BASE_URL, headers=headers, params=params, timeout=10)
# यदि हब 200 HTTP लौटाता है, तो लॉग/अलर्ट में दृश्यता के लिए उठाएं।
resp.raise_for_status()
return resp.json()

def main():
# उदाहरण BIN
bin_number = "444444"
data = fetch_bin_info(bin_number)

# फ़ील्ड का उपयोग करने से पहले आपको जो न्यूनतम जांच करनी चाहिए
if not data.get("success"):
print("लुकअप सफल नहीं है:", data)
return

print("BIN मान्य:", data.get("isValid"))
info = data.get("data", {}) or {}

print("हल किया गया BIN/IIN:", info.get("bin_iin"))
print("ब्रांड:", info.get("card_brand"))
print("प्रकार:", info.get("card_type"))
print("स्तर:", info.get("card_level"))
print("जारीकर्ता:", info.get("issuer_name_bank"))
print("जारीकर्ता फोन:", info.get("issuer_bank_phone"))
print("जारीकर्ता देश:", info.get("iso_country_name"), "(", info.get("iso_country_code"), ")")

# उदाहरण: हल्का जोखिम नियम
# if info.get("iso_country_code") not in {"US", "CA", "GB"}:
# flag_reason = "jari_karta_desha_region_se_bahar"

if __name__ == "__main__":
main()

समय बचाने वाले कार्यान्वयन नोट्स

• Authorization: हमेशा Authorization: Bearer YOUR_API_KEY को ठीक उसी तरह भेजें जैसा दिखाया गया है। क्वेरी पैरामीटर में कुंजी न रखें।
• BIN प्रारूप: एंडपॉइंट 6-अंक के BIN की अपेक्षा करता है जो bin क्वेरी पैरामीटर में है। स्पेस, गैर-अंक, और पूर्ण PANs भेजने से बचें; केवल BIN आवश्यक है।
• कैशिंग: BIN-से-जारीकर्ता मैपिंग अपेक्षाकृत स्थिर हैं। अपने सिस्टम में BIN द्वारा कुंजीबद्ध परिणामों को कैश करें ताकि दोहराए गए कॉल और विलंबता को कम किया जा सके। जब आप अपने लॉग में जारीकर्ता परिवर्तनों का अवलोकन करें तो अमान्य करें।
• सौम्य फॉलबैक: यदि सफलता गलत है या isValid गलत है, तो अपने चेकआउट को प्रतिक्रियाशील रखें। उदाहरण के लिए, आप सामान्य कार्ड हैंडलिंग पर डिफ़ॉल्ट कर सकते हैं और निगरानी बढ़ाते हुए प्राधिकरण की ओर बढ़ सकते हैं।
• लॉगिंग: अवलोकन के लिए log data.bin_iin और जारीकर्ता फ़ील्ड को लॉग करें। पूर्ण कार्ड नंबर लॉग करने से बचें; आपको इस लुकअप के लिए केवल BIN को संभालना चाहिए।
• परीक्षण: विभिन्न ब्रांडों और क्षेत्रों में सामान्य BINs का मिश्रण उपयोग करें ताकि यह सत्यापित किया जा सके कि आपका डाउनस्ट्रीम मार्गदर्शन या जोखिम लॉजिक ब्रांड/प्रकार/स्तर/देश के विभिन्न संयोजनों को संभालता है।

आप इस API के साथ शिप कर सकते हैं सामान्य वित्तीय कार्यप्रवाह

• चेकआउट पूर्व-मान्यता: कार्ड इनपुट को स्वरूपित करने के बाद और भुगतान इरादा बनाने से पहले API को कॉल करें। स्पष्ट रूप से अमान्य BINs को जल्दी अस्वीकार करें या विशिष्ट जारीकर्ताओं के लिए अतिरिक्त सत्यापन की आवश्यकता करें।
• जारीकर्ता-देश मिलान: iso_country_code की तुलना बिलिंग या IP देश से करें ताकि जब वे मेल न खाएं तो स्टेप-अप प्रमाणीकरण को ट्रिगर किया जा सके।
• नेटवर्क मार्गदर्शन संकेत: MASTERCARD बनाम अन्य ब्रांडों को विभिन्न अधिग्रहणकर्ताओं के लिए निर्देशित करें या कार्ड_type के अनुसार अनुकूलित 3DS नीतियों को लागू करें।
• ग्राहक समर्थन समृद्धि: जब एक चार्ज सामान्य अस्वीकृति के साथ विफल हो जाता है, तो एजेंट कंसोल में issuer_name_bank और issuer_bank_phone दिखाएं ताकि समाधान में तेजी लाई जा सके।
• विश्लेषण और निगरानी: प्रदर्शन और चार्जबैक पैटर्न को ट्रैक करने के लिए issuer_name_bank या iso_country_code द्वारा लेनदेन को समेकित करें।

त्रुटि प्रबंधन और लचीलापन

उदाहरण प्रतिक्रिया स्थिति: 200 और सफलता: true के साथ सफल लुकअप का प्रदर्शन करती है। आपकी एकीकरण में:

• HTTP स्थिति कोड की जांच करें और गैर-2xx प्रतिक्रियाओं को उचित रूप से संभालें (यदि आवश्यक हो तो बैकऑफ के साथ पुनः प्रयास करें, आपके कार्य कतार या चेकआउट रणनीति के आधार पर)।
• डेटा फ़ील्ड का उपयोग करने से पहले सफलता और isValid की जांच करें। यदि इनमें से कोई भी जांच विफल होती है, तो सतर्क डिफ़ॉल्ट के साथ जारी रखें।
• नैस्टेड फ़ील्ड को पढ़ने से पहले यह सुनिश्चित करें कि डेटा मौजूद है ताकि None/KeyError समस्याओं से बचा जा सके।

सुरक्षा और अनुपालन संकेत

• केवल BIN (6 अंक) भेजें। इस सेवा को पूर्ण PANs न भेजें।
• अपनी API कुंजी को सर्वर-साइड रहस्यों (जैसे, पर्यावरण चर या एक रहस्य प्रबंधक) में स्टोर करें। इसे क्लाइंट-साइड कोड में उजागर न करें।
• न्यूनतम आवश्यक विवरण लॉग करें और लॉग में PII से बचें। BIN स्वयं कार्डधारक की पहचान करने के लिए पर्याप्त नहीं है, लेकिन इसे अपने सिस्टम में अन्य विशेषताओं के साथ संयम से मिलाएं।

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

आप MCP-संगत क्लाइंट का उपयोग करके Zyla पर APIs को MCP एंडपॉइंट के माध्यम से सक्रिय कर सकते हैं। अपने MCP क्लाइंट को निम्नलिखित URL पर इंगित करें और अपनी Zyla API कुंजी शामिल करें:

MCP

वहां से, आपका AI एजेंट ऊपर दिखाए गए कार्ड चेकर्स API एंडपॉइंट को Authorization हेडर का उपयोग करके कॉल कर सकता है। डेटा समृद्धि (जैसे, संदिग्ध आदेशों के तिरछे के दौरान BIN मान्यता) को स्वचालित करने के लिए एजेंट का उपयोग करें जबकि इस पोस्ट में दस्तावेज़ किए गए सटीक HTTP विधि, URL, और पैरामीटर को बनाए रखें।

सब कुछ एक साथ रखना

एक सामान्य बैकएंड प्रवाह में:

1. क्लाइंट कार्ड इनपुट एकत्र करता है और केवल BIN (पहले 6 अंक) को आपके सर्वर पर भेजता है।
2. आपका सर्वर GET /check-card को bin=XXXXXX और Authorization: Bearer YOUR_API_KEY के साथ अनुरोध करता है।
3. यदि सफलता और isValid सत्य हैं, तो डेटा.card_brand, डेटा.card_type, और जारीकर्ता देश का उपयोग करके मार्गदर्शन या जोखिम नियम लागू करें।
4. दोहराए गए लुकअप से बचने के लिए BIN द्वारा प्रतिक्रिया को कैश करें।
5. अपने भुगतान प्रयास के साथ आगे बढ़ें या आपके द्वारा परिभाषित नियमों के आधार पर 3DS/चुनौती के लिए बढ़ाएं।

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

• 401 या समान प्रमाणीकरण समस्या: पुष्टि करें कि आपका Authorization हेडर ठीक उसी तरह है जैसा Authorization: Bearer YOUR_API_KEY और कि कुंजी सक्रिय है।
• डेटा में कोई फ़ील्ड नहीं: सुनिश्चित करें कि bin पैरामीटर मौजूद है और ठीक 6 अंक हैं।
• अप्रत्याशित त्रुटियाँ: निदान के लिए पूर्ण JSON बॉडी और प्रासंगिक हेडर (रहस्यों को छोड़कर) लॉग करें; चेकआउट को अवरुद्ध करने से बचने के लिए जिम्मेदारी से कतार से पुनः प्रयास करें।
• अपेक्षित से भिन्न जारीकर्ता: जारीकर्ता डेटाबेस विकसित होते हैं; अपने कैश को ताज़ा करें और BIN के लिए नवीनतम प्रतिक्रिया की पुनः जांच करें।

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

एक मान्य BIN कैसा दिखता है?
एक मान्य BIN ठीक 6 अंक है। उपयोगकर्ता इनपुट से किसी भी स्पेस या विभाजकों को भेजने से पहले हटा दें।

क्या मुझे पूर्ण कार्ड नंबर भेजने की आवश्यकता है?
नहीं। केवल 6-अंक का BIN bin क्वेरी पैरामीटर में भेजें।

मैं प्रमाणीकरण कैसे करूँ?
हर अनुरोध पर Bearer YOUR_API_KEY के मान के साथ Authorization हेडर शामिल करें।

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

क्या मैं इसे AI एजेंट से कॉल कर सकता हूँ?
हाँ। MCP एंडपॉइंट की ओर इशारा करते हुए MCP-संगत क्लाइंट का उपयोग करें और सुनिश्चित करें कि जब आपका एजेंट GET कॉल करता है तो Authorization हेडर सेट किया गया है।

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