आपको एक कार्ड को जल्दी से मान्य करने की आवश्यकता है, बिना अपना खुद का BIN डेटाबेस बनाए या विक्रेता स्क्रैपर्स को बनाए रखे। इस गाइड के अंत तक, आप एकल एंडपॉइंट को कॉल करेंगे ताकि एक कार्ड के BIN की जांच की जा सके और ब्रांड, प्रकार, स्तर, जारीकर्ता और देश जैसे प्रमुख गुणों को वापस पढ़ सकें—आपके चेकआउट, जोखिम नियमों या वित्त कार्यप्रवाह में प्लग करने के लिए तैयार।
सरल BIN जांच के साथ आप क्या कर सकते हैं
कार्ड चेकर API एक कार्ड के BIN (बैंक पहचान संख्या) के आधार पर मान्यता और मेटाडेटा लौटाता है। एक अनुरोध के साथ, आप जान सकते हैं कि क्या BIN मान्य है और कार्ड_brand (जैसे, MASTERCARD), कार्ड_प्रकार (जैसे, CREDIT), कार्ड_स्तर (जैसे, GOLD), जारीकर्ता_नाम_बैंक, और iso_country_code जैसे फ़ील्ड प्राप्त कर सकते हैं। वित्त और भुगतान टीमें इसका उपयोग करती हैं:
- प्राधिकरण का प्रयास करने से पहले कार्डों को पूर्व-मान्य करें ताकि अनावश्यक गेटवे कॉल को कम किया जा सके।
- ब्रांड, प्रकार, स्तर, जारीकर्ता, या देश के अनुसार रूटिंग या जोखिम नीतियों को लागू करें।
- विश्लेषण और समन्वय के लिए जारीकर्ता और देश के विवरण के साथ लेनदेन लॉग को बढ़ाएं।
- ग्राहक सहायता उपकरण बनाएं जो पूर्ण PANs को संग्रहीत किए बिना कार्ड गुणों की पहचान करते हैं।
API Zyla API Hub पर सूचीबद्ध है, जो 10,000 से अधिक सार्वजनिक APIs के साथ एक API मार्केटप्लेस है। आपको एक खाता, एक API कुंजी, और एक सदस्यता + कोटा मॉडल मिलता है जो आप द्वारा चुने गए APIs में है—कोई पे-पर-कॉल आश्चर्य नहीं और न ही प्रत्येक विक्रेता के लिए अलग प्रमाणीकरण।
Zyla API Hub पर शुरू करना
कार्ड चेकर API पृष्ठ खोलें और अपनी कुंजी प्राप्त करने के लिए सदस्यता लें। लिस्टिंग 7-दिन की परीक्षण अवधि प्रदान करती है ताकि आप पहले अपने वातावरण में परीक्षण कर सकें। एक बार सदस्यता लेने के बाद, आपके पास एक API कुंजी होगी जिसका आप Zyla एंडपॉइंट्स पर प्रमाणीकरण हेडर के माध्यम से उपयोग कर सकते हैं।
- कार्ड चेकर API पर 7-दिन का परीक्षण शुरू करें
- अन्य वित्त और भुगतान APIs का पता लगाने के लिए हब होमपेज पर जाएं: zylalabs.com
Zyla पर प्रमाणीकरण सीधा है: अपने अनुरोधों में Authorization: Bearer YOUR_API_KEY जोड़ें। बिलिंग सदस्यता + कोटा है, न कि पे-पर-कॉल। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ देखें।
आप जो एंडपॉइंट कॉल करेंगे
कार्ड चेकर API एक सरल एंडपॉइंट को उजागर करता है जो एक BIN को मान्य करता है और कार्ड मेटाडेटा लौटाता है।
- विधि: GET
- URL: https://zylalabs.com/api/2333/card-checker-api/2243/check-card
- आवश्यक क्वेरी पैरामीटर: bin (संख्या)
विवरण: कार्ड विवरण को मान्य करने और पुनः प्राप्त करने के लिए bin पैरामीटर में 6-अंकीय BIN संख्या दर्ज करें।
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: बूलियन जो यह इंगित करता है कि क्या प्रदान किया गया BIN मान्य के रूप में पहचाना गया है।
- message: मानव-पठनीय मान्यता स्थिति।
- data.bin_iin: परिणाम से संबंधित BIN/IIN।
- data.card_brand, data.card_type, data.card_level: रूटिंग और UI लेबल के लिए उपयोगी पहचानकर्ता।
- data.issuer_name_bank, issuer_bank_phone, issuer_bank_website: संदर्भ के लिए आप संग्रहीत कर सकते हैं जारीकर्ता विवरण।
- data.iso_country_name, data.iso_country_code: अनुपालन जांच और धोखाधड़ी नियमों के लिए देश की जानकारी।
Python उदाहरण: एक BIN की जांच करें और मान्यता पर शाखा करें
नीचे दिया गया स्निपेट एक सरल GET कॉल का प्रदर्शन करता है, प्रतिक्रिया को पार्स करता है, और दिखाता है कि आपकी नीति तर्क कहां प्लग करें (जैसे, प्रीपेड क्रेडिट कार्ड को अस्वीकार करें, केवल कुछ देशों की अनुमति दें, या अतिरिक्त सत्यापन के लिए संकेत दें)।
import os
import requests
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
BASE_URL = "https://zylalabs.com/api/2333/card-checker-api/2243/check-card"
def check_bin(bin_number: str) -> dict:
url = f"{BASE_URL}?bin={bin_number}"
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, headers=headers, timeout=10)
resp.raise_for_status()
return resp.json()
if __name__ == "__main__":
result = check_bin("444444")
# Core fields you will commonly use
is_valid = result.get("isValid")
message = result.get("message")
data = result.get("data", {}) or {}
print("BIN मान्य:", is_valid)
print("संदेश:", message)
if is_valid:
brand = data.get("card_brand")
card_type = data.get("card_type")
level = data.get("card_level")
issuer = data.get("issuer_name_bank")
country_code = data.get("iso_country_code")
print("ब्रांड:", brand)
print("प्रकार:", card_type)
print("स्तर:", level)
print("जारीकर्ता:", issuer)
print("देश:", country_code)
# उदाहरण नीति हुक:
# - यदि आपको देश द्वारा प्रतिबंधित करने की आवश्यकता है:
# if country_code not in {"US", "CA", "GB"}:
# print("मैनुअल समीक्षा के लिए रूट")
# - यदि आप केवल कुछ ब्रांडों/प्रकारों को स्वीकार करते हैं:
# if brand != "MASTERCARD" or card_type != "CREDIT":
# print("वैकल्पिक भुगतान विधि दिखाएं")
else:
# जब BIN मान्य नहीं है तो फॉलबैक (जैसे, उपयोगकर्ता से फिर से दर्ज करने के लिए कहें)
print("अमान्य BIN; सुधार के लिए संकेत दें।")
समय बचाने वाले कार्यान्वयन नोट्स
- केवल bin क्वेरी पैरामीटर आवश्यक है। कार्ड संख्या के पहले 6 अंकों का उपयोग करें; अपने सिस्टम में PCI जोखिम को कम करने के लिए पूर्ण PANs को संचारित न करें।
- प्रदर्शन: BIN लुकअप हल्के होते हैं, आपके चेकआउट फॉर्म में धुंधला घटनाओं पर ट्रिगर करने के लिए आदर्श या प्राधिकरण से पहले सर्वर-साइड। एक सत्र के दौरान दोहराए गए अनुरोधों को कम करने के लिए BIN द्वारा कुंजीबद्ध छोटे क्लाइंट या एज कैशिंग पर विचार करें।
- फॉलबैक UX: यदि isValid गलत है, तो उपयोगकर्ता से पहले 6 अंकों के लिए फिर से संकेत दें। त्रुटि पाठ को तटस्थ रखें: “कृपया अपने कार्ड के पहले 6 अंकों की जांच करें।”
- Normalization: API द्वारा दिए गए ब्रांड/प्रकार/स्तर मानों को संग्रहीत करें (जैसे, MASTERCARD, CREDIT) और उन्हें अपनी सीमा पर किसी भी आंतरिक enums से मैप करें।
- ऑडिटिंग: अपने भुगतान ऑडिट लॉग में isValid ध्वज, bin_iin, ब्रांड, प्रकार, स्तर, जारीकर्ता, और iso_country_code को लॉग करें। पूर्ण कार्ड संख्या को संग्रहीत करने से बचें।
वास्तविक दुनिया के वित्त और भुगतान उपयोग के मामले
- चेकआउट फॉर्म ऑप्टिमाइजेशन: जब एक उपयोगकर्ता पहले 6 अंक टाइप करता है, तो कार्ड_brand का पता लगाएं और उपयुक्त ब्रांड आइकन दिखाएं। यदि ब्रांड या प्रकार असमर्थित है, तो सबमिट इवेंट से पहले दूसरे कार्ड के लिए संकेत दें।
- रूटिंग नियम: MASTERCARD CREDIT GOLD कार्डों को उस ब्रांड/प्रकार के लिए सबसे अच्छे इंटरचेंज दर या स्वीकृति प्रोफ़ाइल के साथ गेटवे पर भेजें।
- अनुपालन फ़िल्टर: iso_country_code की जांच करके प्रतिबंधित या असमर्थित देशों से BINs को अस्वीकार या चिह्नित करें।
- धोखाधड़ी ह्यूरिस्टिक्स: IP भू-स्थान, बिलिंग देश, और डिवाइस संकेतों के साथ issuer_name_bank और iso_country_code को संयोजित करें। असंगतताएँ जोखिम स्कोर बढ़ा सकती हैं।
- ग्राहक सहायता: जब एक भुगतान विफल होता है, तो सहायता एजेंट जल्दी से BIN से जारीकर्ता और ब्रांड की पहचान कर सकते हैं ताकि उपयोगकर्ताओं को यदि आवश्यक हो तो अपने बैंक को कॉल करने के लिए मार्गदर्शन किया जा सके।
AI एजेंटों से MCP के माध्यम से उसी API को कॉल करें
यदि आप MCP-संगत क्लाइंट (जैसे, कोड सहायक जो उपकरणों को कॉल कर सकते हैं) का उपयोग करके कार्यों को स्वचालित करते हैं, तो आप MCP एंडपॉइंट के माध्यम से Zyla APIs को सक्रिय कर सकते हैं। अपने क्लाइंट को इस पर इंगित करें:
https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
वहां से, एजेंट को GET विधि और bin क्वेरी पैरामीटर का उपयोग करके कार्ड चेकर API एंडपॉइंट को कॉल करने के लिए निर्देशित करें। यदि आपका MCP क्लाइंट API कुंजी के साथ कॉन्फ़िगर किया गया है तो यह स्वचालित रूप से आपके प्रमाणीकरण हेडर को पास करेगा। MCP उपयोग पर सामान्य जानकारी के लिए, MCP पृष्ठ देखें।
अपने भुगतान प्रवाह में एकीकृत करने के लिए
1) क्लाइंट-साइड प्री-चेक (वैकल्पिक)
जब उपयोगकर्ता पहले 6 अंक दर्ज करता है, तो केवल BIN के साथ अपने बैकएंड को कॉल करें। आपका बैकएंड फिर कार्ड चेकर API को कॉल करता है और एक न्यूनतम पेलोड (ब्रांड, प्रकार, स्तर, देश) लौटाता है। इससे आपके Zyla API कुंजी को ब्राउज़र में उजागर करने से बचा जाता है।
2) प्रमाणीकरण से पहले सर्वर-साइड मान्यता
भुगतान इरादा या प्राधिकरण बनाने से ठीक पहले, यह पुष्टि करने के लिए उसी BIN के साथ API को कॉल करें कि यह मान्य है और आपके लॉग और नियमों के लिए जारीकर्ता और देश को कैप्चर करें। यदि isValid गलत है, तो प्रयास को छोटा करें और एक अलग कार्ड के लिए पूछें।
3) लॉगिंग और विश्लेषण
अपने लेनदेन के प्रयास के साथ प्रमुख फ़ील्ड को संग्रहीत करें ताकि आप अस्वीकृतियों, स्वीकृति, और चार्जबैक को ब्रांड/प्रकार/जारीकर्ता/देश के अनुसार विभाजित कर सकें। इससे समय के साथ रूटिंग और धोखाधड़ी मॉडल को ट्यून करने में मदद मिलती है।
त्रुटि हैंडलिंग पैटर्न
- HTTP परत: अपने पुनः प्रयास नीति के आधार पर गैर-2xx को अस्थायी या टर्मिनल के रूप में मानें। नेटवर्क टाइमआउट को जल्दी से पुनः प्रयास किया जा सकता है; स्थायी 4xx/5xx को लॉग में सहसंबंध आईडी के साथ सतह पर लाना चाहिए।
- प्रतिक्रिया अर्थशास्त्र: उपयोगकर्ता-अनुकूल प्रवाह के लिए isValid बूलियन और संदेश का उपयोग करें। रूटिंग के लिए issuer_bank_website को पार्स करने से बचें जब तक कि आपके पास कोई विशेष कारण न हो—issuer_name_bank और देश अधिक स्थिर चालक हैं।
- लचीलापन: अस्थायी त्रुटियों पर झटके के साथ छोटे गुणात्मक बैकऑफ को लागू करें। अचानक झटके को चेकआउट पर प्रभाव डालने से बचाने के लिए सकारात्मक BIN लुकअप को संक्षिप्त रूप से कैश करें।
सुरक्षा और गोपनीयता नोट्स
- कभी भी अपने BIN-जांचने वाले एंडपॉइंट पर पूर्ण कार्ड नंबर न भेजें। पहले 6 अंकों को निकालें और इस जांच के लिए शेष को छोड़ दें।
- अपनी Zyla API कुंजी को सर्वर-साइड पर रखें; इसे वेब या मोबाइल क्लाइंट में एम्बेड न करें। यदि आप तात्कालिक क्लाइंट UX चाहते हैं तो अपने बैकएंड का उपयोग एक पतले प्रॉक्सी के रूप में करें।
- केवल वही लॉग करें जो आपको चाहिए। BIN, ब्रांड, प्रकार, स्तर, जारीकर्ता, और देश आमतौर पर विश्लेषण और नियमों के लिए पर्याप्त होते हैं।
इंजीनियरिंग बाधाओं के भीतर काम करना
- लेटेंसी बजट: BIN जांच तेज है और इसे फॉर्म प्रविष्टि के दौरान या प्राधिकरण से ठीक पहले किया जा सकता है। यदि आप अत्यधिक लेटेंसी-संवेदनशील हैं, तो BIN द्वारा कुंजीबद्ध क्लाइंट या एज कैश जोड़ें।
- Idempotency: अनुरोध एक पढ़ाई है; इसे idempotent मानें। आप अस्थायी विफलताओं पर सुरक्षित रूप से पुनः प्रयास कर सकते हैं।
- अंतर्राष्ट्रीयकरण: iso_country_code ISO अल्फा-2 है (जैसे, TR)। इसे प्रदर्शित नामों या देश-विशिष्ट व्यावसायिक नियमों के लिए अपने स्थानीयकरण परत में मैप करें।
संदर्भ: एंडपॉइंट पुनर्कथन
- GET https://zylalabs.com/api/2333/card-checker-api/2243/check-card
- क्वेरी पैरामीटर: bin (संख्या, आवश्यक)। उदाहरण: 444444
- प्रमाणन हेडर: Authorization: Bearer YOUR_API_KEY
- प्रतिक्रिया फ़ील्ड जिन्हें आप आमतौर पर उपयोग करेंगे: isValid, message, data.bin_iin, data.card_brand, data.card_type, data.card_level, data.issuer_name_bank, data.iso_country_code
उत्पादन के लिए जीवन की गुणवत्ता के सुझाव
- एकीकरण के लिए फीचर फ्लैग ताकि आप बाजार या खंड के अनुसार रोल आउट कर सकें।
- पर्यवेक्षण जोड़ें: अनुरोध की संख्या, 2xx/4xx/5xx दरें, और BIN जांच के लिए p95 लेटेंसी को ट्रैक करें।
- परीक्षणों में अपरिवर्तनीयता बनाएं: JSON को ऊपर मॉक करें ताकि आप TR में MASTERCARD CREDIT GOLD के लिए अपनी रूटिंग तर्क को सत्यापित कर सकें।
- API-प्रदत्त स्ट्रिंग्स (जैसे, “MASTERCARD”) से आपके enums के लिए अपने आंतरिक मैपिंग का दस्तावेजीकरण करें ताकि मौन असंगतियों से बचा जा सके।
अक्सर पूछे जाने वाले प्रश्न
API को कॉल करने के लिए मुझे न्यूनतम क्या चाहिए?
एक मान्य Zyla API कुंजी और कार्ड के पहले 6 अंक (bin पैरामीटर)। Authorization: Bearer YOUR_API_KEY हेडर जोड़ें।
क्या मैं इसे चेकआउट पर बिना पूर्ण कार्ड नंबर संग्रहीत किए उपयोग कर सकता हूँ?
हाँ। केवल पहले 6 अंक (BIN) भेजें। इस मान्यता चरण के लिए पूर्ण PAN न भेजें या संग्रहीत करें।
मुझे कौन से फ़ील्ड बनाए रखना चाहिए?
आमतौर पर: isValid, bin_iin, card_brand, card_type, card_level, issuer_name_bank, और iso_country_code। ये रूटिंग, धोखाधड़ी, और रिपोर्टिंग के लिए सबसे उपयोगी होते हैं।
क्या कोई मुफ्त योजना है?
कोई मुफ्त योजना नहीं है। लिस्टिंग 7-दिन की परीक्षण अवधि प्रदान करती है ताकि आप प्रतिबद्ध करने से पहले मूल्यांकन कर सकें। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ देखें।
क्या मैं इसे AI कोडिंग एजेंट से कॉल कर सकता हूँ?
हाँ। अपने MCP-संगत क्लाइंट को Zyla MCP एंडपॉइंट का उपयोग करने के लिए कॉन्फ़िगर करें, फिर इसे bin पैरामीटर के साथ कार्ड चेकर API को GET कॉल करने दें। विवरण के लिए ऊपर लिंक किए गए MCP पृष्ठ को देखें।
क्या आप मिनटों में कार्ड जांच लागू करने के लिए तैयार हैं? लिस्टिंग खोलें और अपनी परीक्षण अवधि शुरू करें: कार्ड चेकर API पर 7-दिन का परीक्षण शुरू करें। zylalabs.com पर अधिक वित्तीय एकीकरण का अन्वेषण करें और इस सप्ताह अपने मान्यता प्रवाह को भेजें।