कॉन्टेक्स्ट सिग्नल्स

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

कॉन्टेक्स्ट सिग्नल्स पूर्ण हो चुके क्रेडिट लेनदेन का मूल्यांकन करते हैं और आपके स्वयं के एंटी-फ्रॉड निर्णय को समृद्ध करने के लिए एक जोखिम मूल्यांकन — सेल्फ-फ्रॉड या सोशल इंजीनियरिंग — लौटाते हैं।

ये कार्ड नॉट प्रेजेंट सत्यापन के पूरक हैं: ये उन transaction endpoints के कॉन्ट्रैक्ट या व्यवहार को नहीं बदलते जिनका आप पहले से उपयोग कर रहे हैं। आप हमेशा की तरह लेनदेन की टर्मिनल स्थिति (approved, inconclusive, आदि) प्राप्त करते रहते हैं, और फिर कॉन्टेक्स्ट सिग्नल्स को क्वेरी करते हैं।

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

अनुमति-नियंत्रित एक्सेस

इस endpoint तक एक्सेस आपकी कंपनी को असाइन की गई अनुमति (role) द्वारा नियंत्रित होता है। इसके बिना, endpoint 403 लौटाता है। Unico टीम से इसे सक्षम करने का अनुरोध करें।

Base URL

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

कॉन्टेक्स्ट सिग्नल्स प्राप्त करें

GET /transactions/{transaction_id}/signals — किसी पूर्ण हो चुके लेनदेन का जोखिम मूल्यांकन लौटाता है।

जैसे ही लेनदेन अपनी टर्मिनल स्थिति तक पहुंचता है, परिणाम असिंक्रोनस रूप से पहले से गणना कर लिया जाता है, इसलिए यह endpoint केवल पहले से उपलब्ध परिणाम की एक lookup है।

Path parameters

Parameter	Type	Required	Description
transaction_id	string	हां	लेनदेन ID (UUID v4)। उदाहरण के लिए, 6ab1771e-dfab-4e47-8316-2452268e5481।

Headers

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

Request example

GET /api/public/v1/transactions/6ab1771e-dfab-4e47-8316-2452268e5481/signals HTTP/1.1
Host: transactions.transactional.uat.unico.app
Authorization: Bearer {token}
Accept: application/json

200 OK

{
  "signals": {
    "auto_fraud_risk": "high",
    "more_info": {
      "limited_data": false,
      "holder_identified": true
    }
  }
}

Field	Type	Presence	Description
signals.auto_fraud_risk	string (enum)	वैकल्पिक	सेल्फ-फ्रॉड जोखिम स्तर। केवल तभी मौजूद होता है जब पहचाना गया हो।
signals.social_eng_risk	string (enum)	वैकल्पिक	सोशल इंजीनियरिंग जोखिम स्तर। केवल तभी मौजूद होता है जब पहचाना गया हो।
signals.more_info.limited_data	boolean	हमेशा	true जब एक मजबूत मूल्यांकन के लिए पर्याप्त डेटा नहीं है।
signals.more_info.holder_identified	boolean	हमेशा	false जब कार्डधारक की पहचान नहीं की जा सकी।

संभावित जोखिम मान: very_low, low, medium, high, very_high।

जानकारी

auto_fraud_risk और social_eng_risk परस्पर अनन्य हैं — ये कभी भी एक ही response में एक साथ नहीं आते। जब limited_data true होता है, तो दोनों जोखिम फ़ील्ड अनुपस्थित होने की उम्मीद की जाती है, क्योंकि मूल्यांकन के लिए पर्याप्त डेटा नहीं है।

Response examples

सोशल इंजीनियरिंग जोखिम पहचाना गया:

{
  "signals": {
    "social_eng_risk": "very_high",
    "more_info": {
      "limited_data": false,
      "holder_identified": true
    }
  }
}

कोई जोखिम पहचाना नहीं गया — एक सामान्य लेनदेन:

{
  "signals": {
    "more_info": {
      "limited_data": false,
      "holder_identified": true
    }
  }
}

पर्याप्त डेटा नहीं:

{
  "signals": {
    "more_info": {
      "limited_data": true,
      "holder_identified": true
    }
  }
}

कार्डधारक की पहचान नहीं हुई:

{
  "signals": {
    "more_info": {
      "limited_data": false,
      "holder_identified": false
    }
  }
}

Other response codes

त्रुटियां त्रुटियां में वर्णित मानक त्रुटि फ़ॉर्मेट में लौटाई जाती हैं।

HTTP कोड	कोड	स्थिति	क्या करें
202	—	परिणाम अभी तक गणना नहीं हुआ है — असिंक्रोनस प्रोसेसिंग अभी भी जारी है।	जब तक आपको 200 न मिले, कॉल दोहराएं (polling)।
400	40004	transaction_id अमान्य है (UUID v4 नहीं है) या कोई पैरामीटर malformed है।	अनुरोध फिर से भेजने से पहले ID फ़ॉर्मेट ठीक करें।
403	40305	कंपनी के पास इस endpoint के लिए अनुमति (role) सक्षम नहीं है।	Unico टीम से इसे सक्षम करने का अनुरोध करें।
404	40401	लेनदेन नहीं मिला।	लेनदेन ID जांचें।
404	40484	मूल्यांकन के लिए लेनदेन नहीं मिला।	इसे "कोई परिणाम नहीं मिलेगा" मानें और क्वेरी करना बंद करें।
409	40983	लेनदेन अभी तक अपनी टर्मिनल स्थिति तक नहीं पहुंचा है।	फिर से क्वेरी करने से पहले टर्मिनल स्थिति की प्रतीक्षा करें।
500	—	आंतरिक सेवा त्रुटि।	Backoff के साथ पुनः प्रयास करें। यदि यह बनी रहती है, तो Unico सपोर्ट से संपर्क करें।

नियम और सर्वोत्तम प्रथाएं

• लेनदेन के टर्मिनल स्थिति तक पहुंचने के बाद ही endpoint को क्वेरी करें। पहले क्वेरी करने पर 409 लौटता है।
• केवल क्रेडिट लेनदेन का मूल्यांकन किया जाता है। silent mode में कैप्चर किए गए लेनदेन का मूल्यांकन नहीं किया जाता।
• 202 मिलने पर, जब तक आपको 200 न मिले, कॉल दोहराएं। लेनदेन response के 1 सेकंड बाद पहला अनुरोध भेजें, फिर back off करें: 2s, 4s, 8s, 16s — अधिकतम 5 प्रयास।
• सेवा स्तर उद्देश्य लेनदेन के response के 10 सेकंड बाद है।
• 404 को "कोई परिणाम नहीं मिलेगा" मानें और क्वेरी करना बंद करें।
• auto_fraud_risk और social_eng_risk परस्पर अनन्य हैं।