मुख्य सामग्री पर जाएं
GET
एक स्टेप-अप प्राप्त करें
प्रमाणीकरण नया है। ये endpoint आपके एप्लिकेशन के जारीकर्ता द्वारा दिए जाते हैं, जैसे https://<name>.auth.didit.me, और ये कभी आपकी Didit API कुंजी स्वीकार नहीं करते।
स्टेप-अप उस सत्र से संबद्ध होता है जिसने उसे बनाया था: किसी दूसरे सत्र का एक्सेस टोकन 404 लौटाता है। 30 मिनट बीत जाने के बाद pending स्टेप-अप की स्थिति expired हो जाती है।

प्राधिकरण

Authorization
string
header
आवश्यक

POST /token/ से व्यक्ति का एक्सेस token: हेडर typ: at+jwt वाला एक ES256 JWT, जो अधिकतम 5 मिनट के लिए मान्य है। यह आपकी Didit API कुंजी नहीं है।

पथ पैरामीटर

step_up_id
string<uuid>
आवश्यक

POST /step-up/ से प्राप्त id, आपके return_to पर step_up क्वेरी पैरामीटर भी। जो मान UUID नहीं है, उसे JSON नहीं बल्कि 404 पेज मिलता है।

प्रतिक्रिया

स्टेप-अप।

एक सत्यापन जिसे व्यक्ति को कार्रवाई से पहले पास करना होगा।

id
string<uuid>
आवश्यक
उदाहरण:

"94efc2c3-ca84-42fe-900b-6fb61669a7a1"

rule
enum<string>
आवश्यक

वह नियम जिसने इसका अनुरोध किया था। जब कई लागू होते हैं, तो सबसे मजबूत विधि वाला नियम।

उपलब्ध विकल्प:
payout,
device,
bank,
contact
उदाहरण:

"payout"

method
enum<string>
आवश्यक

व्यक्ति क्या करता है: liveness, selfie (Didit के पास पहले से मौजूद चेहरे से मेल खाने वाली लाइवनेस) या full_id (दस्तावेज़ और सेल्फ़ी)। जब Didit के पास उस व्यक्ति का कोई चेहरा मौजूद नहीं होता है, तो उनके द्वारा verification_url खोलने पर selfie बदलकर full_id हो जाता है।

उपलब्ध विकल्प:
liveness,
selfie,
full_id
उदाहरण:

"selfie"

status
enum<string>
आवश्यक

केवल approved पर कार्रवाई करें। review आपकी टीम की समीक्षा की प्रतीक्षा करता है। जब तक verification_url काम कर रहा है, declined अंतिम नहीं है: व्यक्ति पुनः प्रयास कर सकता है, और स्टेप-अप pending पर वापस आ जाता है। superseded का अर्थ है कि किसी अन्य जांच ने इसके सत्यापन का कार्यभार संभाल लिया है, या परिणाम इस स्टेप-अप के लिए नहीं था: एक नया बनाएं।

उपलब्ध विकल्प:
pending,
review,
approved,
declined,
expired,
superseded
उदाहरण:

"pending"

level
enum<string> | null
आवश्यक

एक बार स्वीकृत होने के बाद, सत्यापन जिस स्तर तक पहुँचा।

उपलब्ध विकल्प:
liveness,
liveness_face_match,
full_id,
null
उदाहरण:

null

amount
string | null
आवश्यक

पेआउट राशि, दो दशमलव स्थान।

उदाहरण:

"900.00"

currency
string | null
आवश्यक
उदाहरण:

"USD"

created_at
string<date-time>
आवश्यक
उदाहरण:

"2026-10-17T10:41:14.894632Z"

completed_at
string<date-time> | null
आवश्यक
उदाहरण:

null

expires_at
string<date-time>
आवश्यक

निर्माण के 30 मिनट बाद। स्टेप-अप को पढ़ने पर पहले कोई भी परिणाम एकत्र किया जाता है जिस तक इसका सत्यापन पहुंचा था, इसलिए यह इस समय के बाद भी approved, review या declined पढ़ सकता है; जो अभी भी pending है वह expired पढ़ता है।

उदाहरण:

"2026-10-17T11:11:14.894581Z"

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