الانتقال إلى المحتوى الرئيسي
GET
الحصول على إجراء step-up
المصادقة ميزة جديدة. تُقدَّم هذه الـendpoints من قِبل مُصدِر التطبيق الخاص بك، مثل https://<name>.auth.didit.me، ولا تقبل مفتاح API الخاص بك لدى Didit أبدًا.
تنتمي عملية المصادقة المرحلية (step-up) إلى الجلسة التي أنشأتها، فإذا استخدمت جلسة أخرى رمز الوصول الخاص بها تتلقى الاستجابة 404. تصبح عملية المصادقة المرحلية في الحالة pending بحالة expired بعد مرور 30 دقيقة.

التفويضات

Authorization
string
header
مطلوب

token الوصول الخاص بالشخص من POST /token/: عبارة عن ES256 JWT برأس typ: at+jwt، صالح لمدة 5 دقائق كحد أقصى. ليس مفتاح API الخاص بك في Didit.

معلمات المسار

step_up_id
string<uuid>
مطلوب

معرّف id من POST /step-up/، وهو أيضاً معامل الاستعلام step_up في return_to الخاص بك. تؤدي القيمة التي ليست من نوع UUID إلى صفحة 404، وليس استجابة JSON.

الاستجابة

التحقق الإضافي.

عملية تحقق يتعين على الشخص اجتيازها قبل اتخاذ الإجراء.

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 بأي وجه للشخص بعد، يتحول selfie إلى full_id بمجرد فتحه لـ verification_url.

الخيارات المتاحة:
liveness,
selfie,
full_id
مثال:

"selfie"

status
enum<string>
مطلوب

اتخذ إجراءً فقط عند approved. ينتظر review مراجعة فريقك. لا يعد declined نهائياً طالما أن verification_url يعمل: يمكن للشخص المحاولة مرة أخرى، وتعود خطوة التحقق الإضافي إلى 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 دقيقة بعد الإنشاء. تؤدي قراءة خطوة التوثيق الإضافي (step-up) أولاً إلى جمع أي نتيجة وصل إليها التحقق، لذا يمكن أن تظل قراءته approved أو review أو declined بعد هذا الوقت؛ وتلك التي لا تزال pending تُقرأ expired.

مثال:

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

آخر تعديل في ٧ نوفمبر ٢٠٢٦