क्रेडिट कार्ड Onboarding

शुरू करने से पहले

आपके API अनुरोध access token का उपयोग करके प्रमाणित किए जाते हैं। कोई भी अनुरोध जिसमें वैध access token शामिल नहीं है, त्रुटि लौटाएगा। अधिक जानें प्रमाणीकरण में।

Base URL

• UAT: https://transactions.transactional.uat.unico.app/api/public/v1
• Production: https://transactions.transactional.unico.app/api/public/v1

महत्वपूर्ण

क्रेडिट कार्ड Onboarding या तो एंड यूज़र से सेल्फी का अनुरोध करके और पूरा रजिस्ट्रेशन पूरा करके किया जा सकता है, या अन्य Unico IDCloud प्लेटफ़ॉर्म उत्पादों द्वारा निष्पादित प्रक्रियाओं के बायोमेट्रिक कैप्चर का पुनः उपयोग करके:

• अन्य IDCloud उत्पादों द्वारा जनरेट की गई प्रक्रियाओं का पुनः उपयोग करने के लिए, additionalInfo.processID में संदर्भ प्रक्रिया ID प्रदान करें;
• उपयोग की गई संदर्भ प्रक्रिया 1 घंटे से अधिक पहले पूरी नहीं हुई होनी चाहिए।

क्रेडिट कार्ड वैलिडेट करें

POST /walletid/transaction — एक क्रेडिट कार्ड को वैलिडेट करता है।

Headers

Header	मान
Authorization	Bearer {token} — एक वैध access token।

Body

{
  "identity": { "key": "cpf", "value": "12345678900" },
  "orderNumber": "onboarding-98765",
  "company": "company-id",
  "redirectUrl": "https://yourapp.com/wallet/return",
  "card": {
    "binDigits": "12345678",
    "lastDigits": "1234",
    "expirationDate": "12/2028",
    "name": "John Doe"
  },
  "value": 5000.00,
  "additionalInfo": {
    "externalUserID": "YOUR_EXTERNAL_USER_ID"
  }
}

फ़ील्ड	प्रकार	आवश्यक	विवरण
identity	object	हां	उपयोगकर्ता पहचान जानकारी।
identity.key	string	हां	उपयोगकर्ता पहचानकर्ता की का प्रकार।
identity.value	string	हां	उपयोगकर्ता पहचानकर्ता की का मान।
orderNumber	string	हां	ऑनबोर्डिंग से जुड़ा नंबर। पोर्टल में एक इंडेक्स के रूप में और आपके सिस्टम व कार्ड नॉट प्रेजेंट सत्यापन के बीच एक फॉरेन की के रूप में उपयोग किया जाता है।
company	string	हां	लेनदेन के लिए जिम्मेदार कंपनी की ID, जो Unico द्वारा प्रदान की जाती है।
redirectUrl	string	नहीं	लेनदेन पूरा होने के बाद उपयोगकर्ता को रीडायरेक्ट करने के लिए URL (वेब के लिए एक HTTPS URL, या नेटिव मोबाइल ऐप्स के लिए एक Schema URL)।
card	object	हां	लेनदेन में उपयोग की गई कार्ड जानकारी।
card.binDigits	string	हां	कार्ड के पहले 8 अंक।
card.lastDigits	string	हां	कार्ड के अंतिम 4 अंक।
card.expirationDate	string	नहीं	कार्ड की समाप्ति तिथि।
card.name	string	हां	कार्डधारक का नाम — एन्कोडिंग समस्याओं या स्वीकृति समस्याओं से बचने के लिए इसे सही सुनिश्चित करें।
value	number	नहीं	अधिकतम सुरक्षित मूल्य।
additionalInfo	object	नहीं	अन्य Unico IDCloud प्लेटफ़ॉर्म उत्पादों से बायोमेट्रिक कैप्चर का पुनः उपयोग करने के लिए इस ऑब्जेक्ट को processID के साथ भेजें, और/या इस लेनदेन के लिए साइलेंट सत्यापन सक्षम करने के लिए externalUserID के साथ भेजें।
additionalInfo.processID	string	नहीं	IDCloud प्लेटफ़ॉर्म से संदर्भ प्रक्रिया ID।
additionalInfo.externalUserID	string	नहीं	डिवाइस मेटाडेटा एकत्र करते समय SDK के externalUserId के माध्यम से कॉन्फ़िगर किया गया वही पहचानकर्ता। साइलेंट वैलिडेशन को ट्रिगर करने के लिए ही आवश्यक — इसके बिना, लेनदेन सामान्य रूप से बनाया जाता है लेकिन हमेशा मानक विज़ुअल फ़्लो का पालन करता है।

खतरा

orderNumber फ़ील्ड को उस खरीद के e-commerce सिस्टम में यूनीक ऑर्डर नंबर से भरा जाना चाहिए — एक अलग ट्रांजैक्शनल ID का उपयोग करना गलत है, और मानों को दोबारा उपयोग करने से replicated transaction त्रुटियां ट्रिगर हो सकती हैं।

200 OK

{
  "id": "6ab1771e-dfab-4e47-8316-2452268e5481",
  "status": "processing",
  "link": "https://developers/regional-solutions/card-not-present-verification.unico.app/t/6ab1771e-dfab-4e47-8316-2452268e5481",
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

फ़ील्ड	विवरण
id	बनाए गए लेनदेन की ID।
status	लेनदेन की वर्तमान स्थिति।
link	लेनदेन से संबंधित लिंक। केवल तभी लौटाया जाता है जब additionalInfo.processID नहीं भेजा गया हो।
token	कार्ड नॉट प्रेजेंट सत्यापन वेब SDK को इनिशियलाइज़ करने के लिए साइन किया गया token। केवल तभी लौटाया जाता है जब additionalInfo.processID नहीं भेजा गया हो।

नोट

यदि additionalInfo.externalUserID भेजा गया था और लेनदेन साइलेंट रूप से स्वीकृत हो जाता है, तो प्रतिक्रिया कैप्चर लिंक को भी छोड़ देती है:

{
    "id": "6ab1771e-dfab-4e47-8316-2452268e5481",
    "status": "approved"
}

SDK सेटअप और समय संबंधी आवश्यकताओं सहित पूर्ण फ़्लो के लिए साइलेंट सत्यापन देखें।

वैलिडेशन स्थिति जांचें

GET /walletid/transactions/{transaction_id} — किसी विशिष्ट लेनदेन की वर्तमान स्थिति जांचता है।

Headers

Header	मान
Authorization	Bearer {token} — एक वैध access token।

200 OK

{
  "status": "processing",
  "hasIdentityChanged": false
}

फ़ील्ड	विवरण
status	लेनदेन की वर्तमान स्थिति।
hasIdentityChanged	वैकल्पिक। क्या लेनदेन में पहचान परिवर्तन हुआ।

सभी संभावित स्थितियों के लिए सूचीबद्ध मान देखें। परफॉर्मेंस को ऑप्टिमाइज़ करने के लिए, इस endpoint को पोल करने के बजाय Webhook लागू करें।

त्रुटि प्रतिक्रियाओं के लिए, देखें त्रुटियां — क्रेडिट कार्ड Onboarding।