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

प्राधिकरण

X-Transaction-Token
string
header
आवश्यक

आपके बैकएंड द्वारा POST /v3/transactions/sdk-token/ के माध्यम से मिंट किया गया अल्पकालिक स्कोप्ड token। डिवाइस-फ़ेसिंग /v1/transactions/ endpoint पर Didit SDKs द्वारा उपयोग किया जाता है।

बॉडी

application/json
txnId
string
आवश्यक

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

उदाहरण:

"wd-2026-07-07-0042"

type
string
आवश्यक

लेन-देन श्रेणी (transaction_category पर मैप होती है), उदा. finance, kyc, travelRule, userPlatformEvent, gamblingBet।

उदाहरण:

"travelRule"

info
object
आवश्यक

लेन-देन के मुख्य वित्तीय विवरण (transaction_details पर मैप होते हैं)।

subject
object
आवश्यक

लेन-देन का विषय (आवेदक)। externalUserId को यहाँ अनदेखा कर दिया गया है: विषय की पहचान हमेशा token के vendor_data से लागू की जाती है।

txnDate
string<date-time>

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

zoneId
string

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

counterparty
object

लेन-देन का प्रतिपक्ष (वैकल्पिक)। subject जैसा ही स्वरूप; externalUserId यहाँ सार्थक है।

props
object

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

travelRule
object

Travel Rule विवरण (travel_rule_details पर मैप होता है)। जब एप्लिकेशन के लिए Travel Rule सक्षम होता है, तो Didit आपके द्वारा भेजे गए किसी भी status को अनदेखा करता है और एक्सचेंज को स्वयं संचालित करता है।

includeCryptoScreening
boolean | null

क्रिप्टो ब्लॉकचेन एनालिटिक्स स्क्रीनिंग के लिए प्रति-लेन-देन ओवरराइड (include_crypto_screening से मैप होता है)।

fingerprint_v2
object

didit-fp-v2 डिवाइस फ़िंगरप्रिंट payload। SDKs द्वारा स्वचालित रूप से इंजेक्ट किया जाता है; केवल सीधे वायर API को कॉल करते समय प्रासंगिक।

प्रतिक्रिया

लेन-देन सबमिट किया गया और निगरानी की गई। GET /v3/transactions/{transaction_id}/ के समान विवरण स्वरूप, जिसमें action_required ब्लॉक भी शामिल है जब अंतिम उपयोगकर्ता को फ़ॉलो-अप कार्रवाई पूरी करनी होती है (SDK डिफ़ॉल्ट रूप से इसे स्वचालित रूप से लॉन्च करते हैं)।

एक लेन-देन के लिए पूर्ण निगरानी रिकॉर्ड, जैसा कि 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