क्रेडिट कार्ड वेलिडेटर - बिन चेकर्स एपीआई को ज़ाइला एपीआई हब में PHP का उपयोग करके एकीकृत करें (गाइड)

आपके पास भुगतान फॉर्म हैं जिन्हें भेजना है और कार्डों को तेजी से मान्य करने की आवश्यकता है। इस गाइड के अंत तक, आप PHP से क्रेडिट कार्ड वेलिडेटर - बिन चेकर्स एपीआई को कॉल करेंगे ताकि पहले 6 अंकों (बिन/आईआईएन) को मान्य किया जा सके, जारीकर्ता और ब्रांड डेटा पढ़ा जा सके, और अपने चेकआउट या जोखिम पाइपलाइन को मजबूत किया जा सके बिना अपने खुद के बिन तालिकाओं का निर्माण और रखरखाव किए।

बिन मान्यता का महत्व और आप क्या बनाएंगे

बिन (बैंक पहचान संख्या) - कार्ड के पहले 6 अंक - आपको जारीकर्ता, ब्रांड, प्रकार, और अक्सर देश के बारे में बताता है। आप एक हल्के पूर्व-अधिकृत कदम को वायर करेंगे जो:

• ग्राहक के पहले 6 अंकों को स्वीकार करता है (कभी भी पूर्ण पैन नहीं),
• बिन को मान्य करने के लिए एकल एंडपॉइंट को कॉल करता है,
• कार्ड ब्रांड (जैसे, अमेरिकन एक्सप्रेस), प्रकार (क्रेडिट), और जारीकर्ता संकेत पढ़ता है,
• आपकी धारा को शाखाबद्ध करता है (जैसे, 3डीएस या एससीए संकेत, अनुमत ब्रांड, या अतिरिक्त केवाईसी ट्रिगर्स)।

नीचे सब कुछ क्रेडिट कार्ड वेलिडेटर - बिन चेकर्स एपीआई पर आधारित है जो ज़ाइला एपीआई हब पर वित्त और भुगतान श्रेणी में है।

क्रेडिट कार्ड वेलिडेटर - बिन चेकर्स एपीआई के बारे में

यह एपीआई किसी भी क्रेडिट कार्ड के बिन (पहले 6 अंक) को मान्य करता है और लौटाता है:

• कार्ड ब्रांड और प्रकार,
• कार्ड स्तर (जब उपलब्ध हो),
• जारीकर्ता जानकारी (जब एपीआई के माध्यम से उपलब्ध हो),
• देश की जानकारी (जब उपलब्ध हो)।

यह एक HTTP GET एंडपॉइंट को उजागर करता है जो एक आवश्यक क्वेरी पैरामीटर, bin, लेता है और कार्ड मेटाडेटा के अलावा वैधता की पुष्टि करने वाला संक्षिप्त JSON पेलोड लौटाता है।

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

ज़ाइला एपीआई हब पर शुरू करना

एपीआई कुंजी प्राप्त करने और एंडपॉइंट्स को कॉल करना शुरू करने के लिए:

1. एपीआई पृष्ठ खोलें: क्रेडिट कार्ड वेलिडेटर - बिन चेकर्स एपीआई.
2. सब्सक्राइब पर क्लिक करें (या यदि उपलब्ध हो तो मुफ्त परीक्षण शुरू करें) और चेकआउट पूरा करें। याद रखें: सब्सक्रिप्शन + कोटा मॉडल; कोई पे-पर-कॉल नहीं।
3. डैशबोर्ड से अपनी एपीआई कुंजी कॉपी करें।
4. प्रत्येक अनुरोध को हेडर के साथ प्रमाणित करें: Authorization: Bearer YOUR_API_KEY.

यदि आपके पास अभी तक खाता नहीं है, तो आप जल्दी से रजिस्टर कर सकते हैं ताकि एपीआई कुंजी प्राप्त कर सकें और इसे अपने वातावरण से आजमा सकें।

एंडपॉइंट संदर्भ और कार्यान्वयन (cURL शामिल)

बिन मान्यता के लिए एक एंडपॉइंट है:

• विधि: GET
• यूआरएल: https://zylalabs.com/api/40/credit-card-validator-bin-checker-api/1885/bin-checker
• आवश्यक क्वेरी पैरामीटर:
  • bin (स्ट्रिंग): पहले 6 अंक, जैसे, 346350
• प्रमाणन: Authorization: Bearer YOUR_API_KEY

cURL

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"

यह एक JSON बॉडी लौटाता है जो बताता है कि बिन मान्य है या नहीं और, जब उपलब्ध हो, ब्रांड और जारीकर्ता मेटाडेटा।

PHP एकीकरण गाइड

नीचे दिया गया स्निपेट curl_init का उपयोग करके PHP से उसी एंडपॉइंट को सक्रिय करता है। यह अनुरोध निर्माण, प्रमाणीकरण, और डाउनस्ट्रीम लॉजिक के लिए बुनियादी JSON डिकोडिंग का प्रदर्शन करता है।

PHP (cURL)

<?php
$apiKey = 'YOUR_API_KEY';
$bin = '346350';

$url = 'https://zylalabs.com/api/40/credit-card-validator-bin-checker-api/1885/bin-checker?bin=' . urlencode($bin);

$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . $apiKey,
'Accept: application/json',
],
CURLOPT_TIMEOUT => 10,
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$err = curl_error($ch);
curl_close($ch);

if ($err) {
// परिवहन स्तर की त्रुटि (DNS, TLS, टाइमआउट)
error_log('cURL error: ' . $err);
http_response_code(502);
exit('Upstream error, try again');
}

if ($httpCode < 200 || $httpCode >= 300) {
// हब से गैर-2xx स्थिति
http_response_code(502);
exit('BIN checker unavailable');
}

data = json_decode($response, true);

// फ़ील्ड पढ़ने से पहले रक्षात्मक जांच
if (!is_array($data) || !isset($data['success'])) {
http_response_code(502);
exit('Malformed response');
}

// उदाहरण शाखाबद्ध लॉजिक
if (!empty($data['isValid'])) {
$brand = $data['data']['card_brand'] ?? 'UNKNOWN';
$type = $data['data']['card_type'] ?? 'UNKNOWN';

// एज पर अनुमत ब्रांड/प्रकार लागू करें (उदाहरण)
$allowedBrands = ['AMERICAN EXPRESS', 'VISA', 'MASTERCARD'];
if (!in_array($brand, $allowedBrands, true)) {
http_response_code(400);
exit('Unsupported card brand');
}

// चेकआउट या पूर्व-प्राधिकरण प्रवाह के साथ जारी रखें
echo 'BIN valid. Brand: ' . $brand . ' | Type: ' . $type . PHP_EOL;
} else {
http_response_code(400);
exit('Invalid BIN');
}

जावास्क्रिप्ट (fetch)

const apiKey = 'YOUR_API_KEY';
const bin = '346350';

const url = `https://zylalabs.com/api/40/credit-card-validator-bin-checker-api/1885/bin-checker?bin=${encodeURIComponent(bin)}`;

fetch(url, {
method: 'GET',
headers: {
'Authorization': `Bearer ${apiKey}`,
'Accept': 'application/json'
}
})
.then(async (res) => {
const text = await res.text();
if (!res.ok) {
throw new Error(`HTTP ${res.status}: ${text}`);
}
return JSON.parse(text);
})
.then((json) => {
if (json.isValid) {
const brand = json.data?.card_brand ?? 'UNKNOWN';
const type = json.data?.card_type ?? 'UNKNOWN';
console.log(`BIN valid. Brand: ${brand}, Type: ${type}`);
} else {
console.log('Invalid BIN');
}
})
.catch((err) => {
console.error('Request failed:', err);
});

प्रतिक्रिया संरचना और फ़ील्ड मैपिंग

प्रतिक्रिया में एक शीर्ष-स्तरीय वैधता ध्वज और कई कार्ड विशेषताओं के साथ एक डेटा ऑब्जेक्ट शामिल है जिसका आप रूटिंग या अनुपालन जांच के लिए उपयोग कर सकते हैं। नीचे आधिकारिक नमूना प्रतिक्रिया है जो आपको प्रदान किए गए अनुरोध से मिलेगी।

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

फ़ील्ड नोट्स जो आप वास्तव में उपयोग करेंगे:

• isValid: बूलियन। आपकी धारा के लिए निर्णायक संकेत। यदि गलत है, तो जल्दी अस्वीकार करें।
• data.card_brand: जैसे, अमेरिकन एक्सप्रेस। ब्रांड-स्तरीय रूटिंग और स्वीकृति नीतियों को चलाएं।
• data.card_type: जैसे, क्रेडिट। यदि आपके अधिग्रहण सेटिंग्स भिन्न होती हैं तो डेबिट/क्रेडिट हैंडलिंग को अलग करने के लिए उपयोगी।
• data.bin_iin: अनुरोध बिन का प्रतिध्वनि; लॉगिंग और ऑडिट के लिए अच्छा।
• data.issuer_* / iso_country_*: जब उपलब्ध हो, जोखिम नियंत्रण और देश-आधारित नियमों के लिए उपयोग करें।

नीचे अतिरिक्त पूर्ण JSON उदाहरण हैं जो उसी आधिकारिक नमूने को दोहराते हैं ताकि आप परीक्षणों या फिक्स्चर में बिना संशोधन के कॉपी/पेस्ट कर सकें।

JSON (फिक्स्चर A)

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

JSON (फिक्स्चर B)

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

JSON (फिक्स्चर C)

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

उपयोग के मामले, एमसीपी एकीकरण, और उत्पादन नोट्स

वास्तविक दुनिया के वित्तीय उपयोग के मामले

• चेकआउट पूर्व-मान्यता: स्पष्ट रूप से गलत बिनों को आपके पीएसपी को हिट करने से पहले अस्वीकार करें, गेटवे शुल्क और विलंबता को बचाएं।
• ब्रांड व्हाइटलिस्टिंग: केवल देश या व्यापारी श्रेणी द्वारा समर्थित ब्रांडों को स्वीकार करें।
• एससीए/3डीएस ट्रिगर्स: ब्रांड और प्रकार के आधार पर अनुकूलनात्मक जांच लागू करें।
• जोखिम स्कोरिंग: अपने जोखिम मॉडल में isValid, card_brand, और iso_country_code (जब उपलब्ध हो) को फीड करें।
• समर्थन और रिपोर्टिंग: सामंजस्य डैशबोर्ड के लिए bin_iin और card_brand को स्टोर करें।

एआई एजेंटों से एमसीपी के माध्यम से एपीआई कॉल करना

हर ज़ाइला एपीआई को मॉडल संदर्भ प्रोटोकॉल (एमसीपी) गेटवे के माध्यम से सक्रिय किया जा सकता है। किसी भी एमसीपी-संगत क्लाइंट (जैसे, क्लॉड कोड, कर्सर, विंडसर्फ) को एमसीपी एंडपॉइंट पर इंगित करें और अपनी एपीआई कुंजी प्रदान करें:

• एमसीपी गेटवे: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
• यहां और जानें: एमसीपी

अपने एजेंट के भीतर, एक उपकरण कॉन्फ़िगर करें जो bin क्वेरी और Authorization: Bearer हेडर के साथ बिन चेकर्स एंडपॉइंट पर GET जारी करता है। एजेंट फिर isValid पर शाखाबद्ध कर सकता है और डाउनस्ट्रीम चरणों के लिए data.card_brand को पढ़ सकता है।

उत्पादन नोट्स जो समय बचाते हैं

• प्रमाणन: हमेशा Authorization: Bearer YOUR_API_KEY भेजें। क्वेरी स्ट्रिंग में कुंजी न भेजें।
• इनपुट मान्यता: एपीआई को कॉल करने से पहले सुनिश्चित करें कि bin ठीक 6 अंकों की संख्या है।
• टाइमआउट और पुनः प्रयास: नेटवर्क कॉल विफल होते हैं; एक क्लाइंट टाइमआउट सेट करें (जैसे, 5-10 सेकंड) और अस्थायी 5xx/टाइमआउट स्थितियों के लिए बैकऑफ के साथ पुनः प्रयास करें।
• कैशिंग: बिन डेटा अपेक्षाकृत स्थिर है। विलंबता और कोटा को कम करने के लिए घंटों या दिनों के लिए bin द्वारा कुंजीबद्ध प्रतिक्रियाओं को कैश करें।
• त्रुटि हैंडलिंग: HTTP स्थिति की जांच करें और नेस्टेड फ़ील्ड पढ़ने से पहले JSON स्कीमा को सत्यापित करें। यदि फ़ील्ड शून्य या अस्पष्ट हैं (जैसे, "एपीआई केवल") तो सुचारू रूप से वापस जाएं।
• डेटा न्यूनतमकरण: केवल बिन भेजें, कभी भी पूर्ण कार्ड पैन या सीवीवी को इस एंडपॉइंट पर न भेजें।
• पर्यवेक्षण: ऑडिट और ट्यूनिंग के लिए bin, isValid, card_brand, और HTTP स्थिति को लॉग करें (पूर्ण पैन को स्टोर करने से बचें)।
• पर्यावरण पृथक्करण: प्रत्येक पर्यावरण के लिए अलग कुंजी; कभी भी कोड में कुंजी को प्रतिबद्ध न करें।

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

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

1) मुझे कौन सा सटीक एंडपॉइंट और विधि कॉल करनी चाहिए?
GET का उपयोग करें: https://zylalabs.com/api/40/credit-card-validator-bin-checker-api/1885/bin-checker?bin=346350 (कोड bin मान को बदलें)। हेडर में शामिल करें Authorization: Bearer YOUR_API_KEY.

2) कौन से पैरामीटर आवश्यक हैं?
केवल एक क्वेरी पैरामीटर आवश्यक है: bin (स्ट्रिंग), कार्ड के पहले छह अंक।

3) प्रतिक्रिया कैसी दिखती है?
बॉडी में status, success, isValid, message, और data ऑब्जेक्ट शामिल है जिसमें bin_iin, card_brand, और card_type जैसे फ़ील्ड हैं। ऊपर JSON नमूनों को देखें।

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

5) क्या मैं इसे एआई एजेंट से कॉल कर सकता हूँ?
हाँ। https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY पर ज़ाइला एमसीपी गेटवे का उपयोग करें और अपने एजेंट को आवश्यक प्रमाणीकरण हेडर के साथ बिन चेकर्स एंडपॉइंट पर GET जारी करने के लिए कॉन्फ़िगर करें।

क्या आप अपने PHP चेकआउट या जोखिम सेवा में बिन मान्य करने के लिए तैयार हैं? अपना खाता बनाएं, एपीआई की सदस्यता लें, और अपनी कुंजी प्राप्त करें: रजिस्टर. आप कभी भी ज़ाइला एपीआई हब पर अतिरिक्त वित्त और भुगतान एपीआई का अन्वेषण कर सकते हैं और क्रेडिट कार्ड वेलिडेटर - बिन चेकर्स एपीआई के लिए समर्पित लिस्टिंग पृष्ठ।