मुख्य सामग्री पर जाएं
POST
curl

यह स्टेटलेस क्यों है

स्टैंडअलोन वॉलेट स्क्रीनिंग लेन-देन तालिका में कुछ भी नहीं लिखती, इसलिए इस endpoint के पास रेंडर करने के लिए कोई संग्रहीत रिकॉर्ड नहीं होता। इसके बजाय, आप POST /v3/wallet-screening/ से मिला बिल्कुल वही JSON दोबारा भेजते हैं, और Didit उस payload को किसी प्रदाता को फिर से कॉल किए बिना PDF में रेंडर करता है।

report_signature फ़ील्ड

POST /v3/wallet-screening/ का हर रिस्पॉन्स अब एक report_signature फ़ील्ड शामिल करता है, जो आपके एप्लिकेशन तक सीमित एक अपारदर्शी हस्ताक्षर है। यह endpoint रेंडर करने से पहले इसे सत्यापित करता है, ताकि कॉलर risk_score, severity, sanctions_hit या किसी अन्य फ़ील्ड को बदलकर ऐसे परिणाम के लिए साफ़-सुथरा दिखने वाला Didit ब्रांडेड PDF न पा सके, जो Didit ने कभी तैयार ही नहीं किया। हमेशा पूरी रिस्पॉन्स बॉडी बिना बदले दोबारा भेजें, report_signature सहित। कुंजियों का क्रम बदलना ठीक है; किसी भी हस्ताक्षरित मान को बदलना ठीक नहीं है।

बिलिंग

प्रदाता को कोई कॉल नहीं किया जाता और कोई शुल्क नहीं लिया जाता। यह केवल उस परिणाम को दोबारा रेंडर करता है जिसके लिए आपने POST /v3/wallet-screening/ कॉल करते समय पहले ही भुगतान कर दिया था।

त्रुटियाँ

अगले चरण

वॉलेट स्क्रीन करें

अंतर्निहित मांग-आधारित वॉलेट स्क्रीनिंग चलाएँ और यहाँ दोबारा भेजने के लिए JSON परिणाम प्राप्त करें।

ऑन-डिमांड वॉलेट स्क्रीनिंग

स्टैंडअलोन वॉलेट-स्क्रीनिंग endpoint और परिणाम मॉडल का अवलोकन।

प्राधिकरण

x-api-key
string
header
आवश्यक

आपकी एप्लिकेशन की API कुंजी, Business Console में Developers -> API keys से। प्राथमिक कुंजी के पास पूर्ण एक्सेस होता है। एक नामित कुंजी को स्कोप किया जा सकता है: प्रति संसाधन none, read या write, कुछ वर्कफ़्लो या स्वीकृत सत्रों तक सीमित, IP पतों की सूची तक सीमित, और समाप्ति तिथि तक सीमित। 401 का अर्थ है कि कुंजी गलत है, निरस्त कर दी गई है या उसकी समय-सीमा समाप्त हो गई है; 403 का अर्थ है कि कोई कुंजी नहीं भेजी गई थी, कुंजी के पास इस संसाधन या कार्रवाई का एक्सेस नहीं है, या अनुरोध उसकी IP सूची से बाहर के पते से आया था; सत्र रूट पर 404 का अर्थ है कि सत्र कुंजी के वर्कफ़्लो या स्थितियों से बाहर है। मीडिया एक्सेस के बिना एक कुंजी को छवि, वीडियो और PDF URL null के रूप में प्राप्त होते हैं, और सत्र write के बिना एक कुंजी को सत्र लिंक और token null के रूप में प्राप्त होते हैं। देखें https://docs.didit.me/console/api-keys।

बॉडी

application/json

POST /v3/wallet-screening/ द्वारा लौटाया गया अपरिवर्तित JSON ऑब्जेक्ट, जिसमें report_signature शामिल है।

POST /v3/wallet-screening/ रिस्पॉन्स के समान आकार — report_signature सहित, उस रिस्पॉन्स बॉडी को ठीक वैसे ही वापस पास करें।

provider
string
आवश्यक

वह प्रदाता जिसने स्क्रीनिंग की (उदा. merklescience, crystal)।

screening_type
enum<string>
आवश्यक

इस endpoint के लिए हमेशा WALLET_SCREENING।

उपलब्ध विकल्प:
WALLET_SCREENING
risk_score
integer
आवश्यक

सामान्यीकृत 0-100 जोखिम स्कोर। उच्च मान का अर्थ है जोखिम भरी संस्थाओं के प्रति अधिक जोखिम। Merkle Science किसी पते को 0-5 तक ग्रेड करता है, जो 0, 15, 35, 55, 75 या 95 पर मैप होता है।

severity
enum<string>
आवश्यक

risk_score से प्राप्त जोखिम बकेट: 0-9 UNKNOWN, 10-39 LOW, 40-69 MEDIUM, 70-89 HIGH, 90-100 CRITICAL। UNKNOWN सबसे निचला बैंड है, कोई अलग नो-डेटा स्थिति नहीं: risk_score 0 (सामान्य साफ़-पते का मामला) का अर्थ कोई प्रतिकूल आकलन नहीं है, जबकि 1-9 रेंज में एक गैर-शून्य स्कोर एक वास्तविक लेकिन उप-LOW सिग्नल है - केवल बैंड ही नहीं, बल्कि risk_score पढ़ें। UNKNOWN को कभी भी सकारात्मक कम-जोखिम या स्पष्ट रेटिंग के रूप में न मानें; इसे पास के रूप में प्रदर्शित न करें।

उपलब्ध विकल्प:
UNKNOWN,
LOW,
MEDIUM,
HIGH,
CRITICAL
status
enum<string>
आवश्यक

स्क्रीनिंग परिणाम की स्थिति।

उपलब्ध विकल्प:
SCREENED,
PENDING,
ERROR
summary
string
आवश्यक

स्क्रीनिंग परिणाम का मानव-पठनीय सारांश।

wallet_address
string
आवश्यक

स्क्रीन किया गया पता, वापस दोहराया गया।

blockchain
string
आवश्यक

वह ब्लॉकचेन जिसकी स्क्रीनिंग की गई थी।

source_of_funds
object[]
आवश्यक

पते को कहाँ से धन प्राप्त हुआ, निकाय द्वारा एट्रिब्यूट किया गया। प्रत्येक प्रविष्टि एक एक्सपोज़र विवरण है।

destination_of_funds
object[]
आवश्यक

पते ने कहाँ धन भेजा, निकाय द्वारा एट्रिब्यूट किया गया। exposure_direction = outgoing के साथ source_of_funds के समान आइटम संरचना।

counterparty_connections
object[]
आवश्यक

वे संस्थाएँ जिनसे प्रदाता जाँचे गए पते को संबद्ध करता है। Merkle Science के लिए ये पते के अपने स्वामी और उपयोगकर्ता टैग से आती हैं, इसलिए एक ही संस्था दो बार दिखाई दे सकती है, और वे कोई फ़ंड फ़्लो नहीं ले जाती हैं: received_usd, sent_usd, received_hops और sent_hops null हैं और percentage 0 है। यहाँ risk_level या is_direct पर रूट न करें: निर्णय के लिए sanctions_hit, dominant_risk_category और risk_factors[].is_high_risk का उपयोग करें, और प्रत्यक्षता के लिए source_of_funds/destination_of_funds में exposure_type का उपयोग करें।

sanctions_hit
boolean
आवश्यक

यदि पते पर प्रत्यक्ष या अप्रत्यक्ष प्रतिबंध जोखिम है तो True।

dominant_risk_category
string | null
आवश्यक

उच्चतम भारित उच्च-जोखिम वाली श्रेणी, या कोई प्रमुख न होने पर null (उदा. sanctioned, mixer, stolen_funds)।

report_signature
string
आवश्यक

इस सटीक परिणाम पर अपारदर्शी HMAC-SHA256 हस्ताक्षर, जो आपके एप्लिकेशन तक सीमित है। अपने आप में इसका कोई अर्थ नहीं है — इसे PDF के रूप में प्रस्तुत करने के लिए पूरे रिस्पॉन्स बॉडी को, बिना किसी बदलाव के और इस फ़ील्ड सहित, POST /v3/wallet-screening/pdf/ पर पुनः पोस्ट करें। यदि report_signature मौजूद नहीं है या पुनः पोस्ट करने से पहले किसी भी हस्ताक्षरित फ़ील्ड (उदा. risk_score, severity, sanctions_hit) को संपादित किया गया था, तो PDF endpoint अनुरोध को 400 के साथ अस्वीकार कर देता है।

transaction_hash
string | null

लेन-देन स्क्रीनिंग फ़ील्ड, रिज़ल्ट शेप के साथ साझा किया गया। वॉलेट स्क्रीनिंग परिणाम पर हमेशा null।

block_timestamp
string | null

लेन-देन स्क्रीनिंग फ़ील्ड, रिज़ल्ट शेप के साथ साझा किया गया। वॉलेट स्क्रीनिंग परिणाम पर हमेशा null।

total_value_usd
number | null

लेन-देन स्क्रीनिंग फ़ील्ड, रिज़ल्ट शेप के साथ साझा किया गया। वॉलेट स्क्रीनिंग परिणाम पर हमेशा null।

fee_usd
number | null

लेन-देन स्क्रीनिंग फ़ील्ड, रिज़ल्ट शेप के साथ साझा किया गया। वॉलेट स्क्रीनिंग परिणाम पर हमेशा null।

sender_rows
object[]

लेन-देन स्क्रीनिंग फ़ील्ड, रिज़ल्ट शेप के साथ साझा किया गया। वॉलेट स्क्रीनिंग परिणाम पर हमेशा खाली।

receiver_rows
object[]

लेन-देन स्क्रीनिंग फ़ील्ड, रिज़ल्ट शेप के साथ साझा किया गया। वॉलेट स्क्रीनिंग परिणाम पर हमेशा खाली।

transaction_flows
object[]

लेन-देन स्क्रीनिंग फ़ील्ड, रिज़ल्ट शेप के साथ साझा किया गया। वॉलेट स्क्रीनिंग परिणाम पर हमेशा खाली।

transaction_flows_status
string | null

लेन-देन स्क्रीनिंग फ़ील्ड, रिज़ल्ट शेप के साथ साझा किया गया। वॉलेट स्क्रीनिंग परिणाम पर हमेशा null।

transaction_flows_error
string | null

लेन-देन स्क्रीनिंग फ़ील्ड, रिज़ल्ट शेप के साथ साझा किया गया। वॉलेट स्क्रीनिंग परिणाम पर हमेशा null।

network_nodes
object[]

लेन-देन स्क्रीनिंग के लिए एक्सपोज़र ग्राफ़ नोड। वॉलेट स्क्रीनिंग परिणाम में खाली।

network_edges
object[]

लेन-देन स्क्रीनिंग के लिए एक्सपोज़र ग्राफ़ एज। वॉलेट स्क्रीनिंग परिणाम में खाली।

pep_counterparty
boolean | null

राजनीतिक रूप से उजागर व्यक्ति से संबंधित एक्सपोज़र। जब कोई PEP परिणाम उपलब्ध न हो तब null, जो कि आज का हर परिणाम है क्योंकि कोई भी प्रदाता इसकी रिपोर्ट नहीं करता; केवल एक स्पष्ट नकारात्मक स्क्रीनिंग परिणाम के लिए false। null को पूर्ण PEP जांच न समझें।

risk_factors
object[]

risk_score का क्रमबद्ध स्पष्टीकरण: इस निर्णय को उत्पन्न करने वाले कारक। प्रदाता अपने स्वयं के मॉडल पर पते का मूल्यांकन करते हैं और केवल एक निर्णय लौटाते हैं (Merkle Science एक पूर्णांक 0-5 लौटाता है), इसलिए केवल स्कोर पर कार्रवाई नहीं की जा सकती। पहले उच्च-जोखिम वाले, फिर प्रत्येक कारक के माध्यम से स्थानांतरित मूल्य के अनुसार क्रमित, अधिकतम पाँच सबसे मजबूत कारकों तक सीमित; source_of_funds और destination_of_funds में हमेशा पूरा ब्रेकडाउन होता है। बिना किसी is_high_risk प्रविष्टि वाले उच्च risk_score का अर्थ है कि प्रदाता ने किसी प्रतिबंध या संबद्ध-इकाई मिलान की सूचना नहीं दी और पते का मूल्यांकन विशुद्ध रूप से अपने स्वयं के एक्सपोज़र मॉडल पर किया - summary इसे स्पष्ट रूप से बताता है।

raw_response
object

प्रदाता का अपना payload। इसका आकार प्रदाता-विशिष्ट है और बिना किसी सूचना के बदल सकता है: इसे पार्स करने के बजाय सामान्यीकृत फ़ील्ड पढ़ें।

प्रतिक्रिया

रेंडर किया गया PDF दस्तावेज़, सीधे बाइनरी application/pdf के रूप में लौटाया गया — कोई JSON रैपर नहीं है।

The response is of type file.

अंतिम संशोधन 7 नवंबर 2026