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

प्राधिकरण

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
transaction_id
string
आवश्यक

इस लेन-देन के लिए आपका विशिष्ट पहचानकर्ता (अधिकतम 128 वर्ण)।

उदाहरण:

"your-txn-2026-05-17-001"

transaction_category
enum<string>
आवश्यक

लेन-देन की श्रेणी। CamelCase उपनाम (travelRule, userPlatformEvent, gamblingBet, …) भी स्वीकार किए जाते हैं; बहु-शब्द श्रेणियों के लिए संग्रहीत/इको किया गया मान camelCase होता है।

उपलब्ध विकल्प:
finance,
kyc,
travel_rule,
user_event,
audit_trail_event,
gambling_bet,
gambling_limit_change,
gambling_bonus_change,
travelRule
उदाहरण:

"finance"

transaction_details
object
आवश्यक

लेन-देन के मुख्य वित्तीय विवरण।

subject
object
आवश्यक

लेन-देन का विषय (आवेदक)।

transaction_at
string<date-time>

लेन-देन कब हुआ। छोड़े जाने पर डिफ़ॉल्ट रूप से वर्तमान समय।

time_zone
string

IANA समय क्षेत्र पहचानकर्ता, उदाहरण के लिए Europe/Madrid।

counterparty
object

लेन-देन का प्रतिपक्ष (वैकल्पिक)।

custom_properties
object

लेन-देन से जुड़े मनमाने की-वैल्यू पेयर। प्रत्येक कुंजी को नियम शर्तों में फ़ील्ड पथ custom_values.<key> के साथ संदर्भित किया जा सकता है।

उदाहरण:
travel_rule_details
object

Travel Rule डेटा। जब Travel Rule सक्षम हो और transaction_category travel_rule हो, तो Didit स्वयं एक्सचेंज चलाता है: यह status, protocol, required और obligations_count को अनदेखा करता है, और originator_data, beneficiary_data और metadata का उपयोग करता है। अन्यथा Didit इन मानों को एक निष्क्रिय Travel Rule रिकॉर्ड के रूप में संग्रहीत करता है। जब Travel Rule चालू हो, तो आपके थ्रेशोल्ड पर या उससे अधिक का आउटबाउंड ट्रांसफ़र उस व्यवस्था की आवश्यकतानुसार डेटा ले जाना चाहिए (EU TFR या FATF Recommendation 16), जिसकी जाँच आपके द्वारा भेजे गए पक्षों पर की जाती है: एक अनुपलब्ध फ़ील्ड travel_rule_details.originator_data या travel_rule_details.beneficiary_data के तहत 400 रिस्पॉन्स देती है, उदाहरण के लिए "EU TFR के लिए प्रेषक का नाम आवश्यक है।"

network_snapshot
object

पहले से परिकलित नेटवर्क ग्राफ़ स्नैपशॉट।

include_crypto_screening
boolean | null

क्रिप्टो ब्लॉकचेन एनालिटिक्स स्क्रीनिंग के लिए प्रति-लेन-देन ओवरराइड। जब true होता है, तो एप्लिकेशन डिफ़ॉल्ट की परवाह किए बिना क्रिप्टो स्क्रीनिंग की जाती है। जब false होता है, तो एप्लिकेशन सेटिंग्स में सक्षम होने पर भी क्रिप्टो स्क्रीनिंग छोड़ दी जाती है। न दिए जाने या null होने पर, Console में कॉन्फ़िगर किए गए एप्लिकेशन-स्तरीय डिफ़ॉल्ट का उपयोग किया जाता है। क्रिप्टो स्क्रीनिंग के लिए transaction_details.direction, currency_kind: "crypto", एक चेन/करेंसी, और दिशा द्वारा चयनित पते की आवश्यकता होती है: इनबाउंड प्री-ट्रांसफ़र स्क्रीनिंग counterparty.payment_method.account_id का उपयोग करती है, इनबाउंड लेन-देन-हैश स्क्रीनिंग subject.payment_method.account_id का उपयोग करती है, और आउटबाउंड स्क्रीनिंग counterparty.payment_method.account_id का उपयोग करती है। जब transaction_details.payment_reference_id में ब्लॉकचेन लेन-देन हैश शामिल होता है, तो Didit लेन-देन स्क्रीनिंग करता है और उपलब्ध होने पर लेन-देन सारांश संवर्धन लौटाता है।

प्रतिक्रिया

लेन-देन सबमिट किया गया और निगरानी की गई। मुख्य भाग पूरा लेन-देन विवरण है (GET /v3/transactions/{transaction_id}/ के समान स्वरूप), जो पहले से लागू किए गए किसी भी नियम के परिणामों को दर्शाता है।

एक लेन-देन के लिए पूर्ण निगरानी रिकॉर्ड, जैसा कि GET /v3/transactions/{transaction_id}/ और POST /v3/transactions/ द्वारा लौटाया जाता है।

uuid
string<uuid>

Didit-स्थायी लेन-देन आइडेंटिफ़ायर। फ़ॉलो-अप कॉल के लिए {transaction_id} के रूप में उपयोग करें।

environment
enum<string>

उस एप्लिकेशन का एनवायरनमेंट जिसके पास लेन-देन का स्वामित्व है। एक sandbox लेन-देन संग्रहीत किया जाता है लेकिन उसका कभी मूल्यांकन, स्क्रीनिंग, अधिसूचना या बिलिंग नहीं की जाती है, इसलिए इसके खाली rule_runs का अर्थ "मूल्यांकन नहीं किया गया" है।

उपलब्ध विकल्प:
live,
sandbox
transaction_number
integer

कंसोल में दिखाया गया एप्लिकेशन-स्कोप क्रमिक लेन-देन नंबर (उदा. 4123)।

txn_id
string

निर्माण के समय आपके द्वारा प्रदान किया गया transaction_id (अधिकतम 128 वर्ण)। प्रति एप्लिकेशन अद्वितीय।

txn_date
string<date-time>

लेन-देन कब हुआ (transaction_at से; डिफ़ॉल्ट रूप से सबमिशन का समय)।

zone_id
string | null

निर्माण के समय प्रदान किया गया IANA समय क्षेत्र पहचानकर्ता।

transaction_type
string

संग्रहीत शीर्ष-स्तरीय श्रेणी: finance, kyc, travelRule, userPlatformEvent, gamblingBet, gamblingLimitChange, gamblingBonusChange, auditTrailEvent। ध्यान दें कि कई शब्दों वाले मान camelCase में वापस दिए जाते हैं, भले ही उन्हें snake_case में सबमिट किया गया हो।

action_type
string

श्रेणी के भीतर उप-प्रकार (जैसे deposit, withdrawal, transfer)। प्रदान न किए जाने पर डिफ़ॉल्ट रूप से श्रेणी पर सेट होता है।

direction
enum<string>

विषय (subject) के सापेक्ष दिशा। सबमिट किए गए केस की परवाह किए बिना अपरकेस में संग्रहीत किया जाता है (इनपुट पर in/out/inbound/outbound स्वीकार किए जाते हैं)।

उपलब्ध विकल्प:
INBOUND,
OUTBOUND
status
enum<string>

वर्तमान निगरानी निर्णय। लेन-देन APPROVED के रूप में बनाए जाते हैं; नियम उन्हें समकालिक रूप से IN_REVIEW/DECLINED में बदल सकते हैं।

उपलब्ध विकल्प:
APPROVED,
IN_REVIEW,
DECLINED,
AWAITING_USER
source
enum<string>

रिकॉर्ड की उत्पत्ति कैसे हुई: API या SDK के माध्यम से सबमिट किए गए लेन-देन के लिए LIVE, कंसोल इंपोर्ट के माध्यम से लोड किए गए लेन-देन के लिए IMPORTED।

उपलब्ध विकल्प:
LIVE,
IMPORTED
amount
string

अनुगामी शून्यों को हटाकर दशमलव स्ट्रिंग के रूप में लेन-देन राशि (उदा. "1500", "0.5", "0.123456789012345678")। 18 दशमलव स्थानों तक।

currency
string

amount का मुद्रा कोड। कोई भी ISO 4217 वर्णमाला कोड स्वीकार किया जाता है (उदा. EUR, USD, NGN), साथ ही क्रिप्टो एसेट सिंबल (उदा. BTC) भी। वर्तमान में प्रचलन में मौजूद कोड को प्राथमिकता दें। प्रत्येक स्वीकृत कोड के लिए विनिमय दर उपलब्ध नहीं होती है: जब कोड के लिए कोई दर उपलब्ध नहीं होती (उदाहरण के लिए ISO अकाउंटिंग यूनिट XSU, या कोई क्रिप्टो सिंबल जिसका मूल्य Didit निर्धारित नहीं करता), तो स्वचालित रूपांतरण विफल हो जाता है और preferred_currency_amount तब तक null वापस किया जाता है जब तक कि अनुरोध में पहले से रूपांतरित amount_in_default_currency प्रदान न किया गया हो।

currency_type
string | null

fiat या crypto, जैसा कि currency_kind में सबमिट किया गया है।

amount_in_default_currency
string | null

आपके द्वारा प्रदान की गई पूर्व-रूपांतरित राशि, अंत में आने वाले शून्यों को हटाकर एक दशमलव स्ट्रिंग के रूप में।

default_currency_code
string | null
preferred_currency_amount
string | null

amount को एप्लिकेशन की पसंदीदा मुद्रा में परिवर्तित किया गया, जब उपलब्ध हो।

preferred_currency_code
string | null
payment_details
string | null

सबमिशन से प्राप्त मुक्त-पाठ भुगतान संदर्भ या मेमो।

payment_txn_id
string | null

payment_reference_id से बाहरी भुगतान प्रणाली संदर्भ (उदा. ब्लॉकचेन लेन-देन हैश)।

score
integer

नियमों द्वारा संचित जोखिम स्कोर (आमतौर पर 0–100)। अधिक = अधिक जोखिम भरा।

severity
enum<string> | null

नियमों/प्रदाताओं द्वारा निर्धारित श्रेणीबद्ध जोखिम गंभीरता (UNKNOWN, LOW, MEDIUM, HIGH, CRITICAL)। जब तक कोई इसे सेट नहीं करता तब तक null।

उपलब्ध विकल्प:
UNKNOWN,
LOW,
MEDIUM,
HIGH,
CRITICAL
decision_reason_code
string | null

वर्तमान status का मशीन-पठनीय कारण।

decision_reason_label
string | null

decision_reason_code के लिए मानव-पठनीय लेबल।

vendor_data
string | null

आवेदक के vendor_data की सुविधा के लिए प्रतिलिपि।

metadata
object

निर्माण समय पर सबमिट किए गए अनुसार subject और counterparty payload का स्नैपशॉट।

props
object

निर्माण के समय आपके द्वारा प्रदान किए गए custom_properties। प्रत्येक कुंजी को नियम शर्तों में custom_values.<key> के रूप में संदर्भित किया जा सकता है।

tags
object[]

लेन-देन से जुड़े टैग (मैन्युअल रूप से या नियमों द्वारा)।

parties
object[]

लेन-देन पक्ष (आवेदक, प्रतिपक्ष)।

payment_methods
object[]

लेन-देन से जुड़ी भुगतान विधियां।

documents
object[]

कंसोल से लेन-देन से जुड़ी फ़ाइलें। कोई न होने पर []।

activities
object[]

गतिविधि लॉग प्रविष्टियाँ (निर्माण, नोट्स, मैन्युअल समीक्षा, स्थिति परिवर्तन)।

alerts
object[]

वर्तमान में हमेशा खाली। एक खुला अलर्ट IN_REVIEW या AWAITING_USER स्थिति वाला लेन-देन होता है।

rule_runs
object[]

प्रति-नियम निष्पादन परिणाम — कौन सा नियम ट्रिगर हुआ, और उसका स्कोर पर क्या प्रभाव पड़ा।

provider_results
object[]

रॉ प्रदाता payloads (AML स्क्रीनिंग, ब्लॉकचेन एनालिटिक्स, आदि)।

travel_rule
object | null

Travel Rule ट्रांसफ़र या जाँच। तब पॉप्युलेट होता है जब travel_rule_details सबमिट किया गया था, और तब भी जब Travel Rule सक्षम हो और लेन-देन transaction_category: travelRule के साथ बनाया गया था (Didit बिना travel_rule_details के भी एक्सचेंज स्वयं शुरू करता है)। कोई ट्रांसफ़र या जाँच मौजूद न होने पर null। इनबाउंड ट्रांसफ़र पर, प्रतिपक्ष का originator_data और beneficiary_data तब तक मास्क रहता है (data_masked: true) जब तक कि वॉलेट स्वामित्व की पुष्टि नहीं हो जाती।

network_snapshot
object | null

नियम इंजन द्वारा उपयोग किए जाने वाले संबंधित लेन-देन/पक्षों का ग्राफ़ स्नैपशॉट। या तो लेन-देन के साथ सबमिट किया गया network_snapshot या वह ग्राफ़ जो Didit एक सफल AML वॉलेट स्क्रीनिंग से बनाता है (जो सबमिट किए गए स्नैपशॉट को बदल देता है)। दोनों में से किसी के भी मौजूद न होने पर null।

remediation
object | null

पुनः सत्यापन आवश्यक होने पर उपयोगकर्ता को पेश किया जाने वाला समाधान सत्र। action_required द्वारा अधिक्रमित, जो कि कैननिकल ब्लॉक है; बैकवर्ड कम्पैटिबिलिटी के लिए रखा गया है।

action_required
Verification session · object

इस लेन-देन को पूरा करने के लिए आवश्यक लंबित अंतिम उपयोगकर्ता कार्रवाई, या कोई न होने पर null। Didit SDK डिफ़ॉल्ट रूप से कार्रवाई को स्वचालित रूप से लॉन्च करते हैं और इसके समाप्त होने पर लेन-देन को रीफ़्रेश करते हैं। type द्वारा विभेदित दो प्रकार: verification_session (एक नियम कार्रवाई द्वारा बनाया गया होस्टेड सत्यापन सत्र) और wallet_ownership (Travel Rule ट्रांसफर के लिए ऑटो-मिंट किया गया वॉलेट-स्वामित्व विजेट सत्र जिसे वॉलेट नियंत्रण के प्रमाण की आवश्यकता होती है, जो auto_wallet_verification Travel Rule सेटिंग द्वारा नियंत्रित होता है)। जब दोनों लागू हो सकते हों, तो wallet_ownership को प्राथमिकता दी जाती है क्योंकि यह Travel Rule एक्सचेंज को रोकता है।

cost_breakdown
object | null

इस लेन-देन की लागत: total_price और items, प्रति शुल्क एक, प्रत्येक में usage_type, price, details और created_at के साथ। उसी लेन-देन की दोबारा स्क्रीनिंग एक नया आइटम होती है।

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