الانتقال إلى المحتوى الرئيسي
POST
المصادقة ميزة جديدة. تُقدَّم نقاط النهاية هذه من خلال جهة الإصدار الخاصة بتطبيقك، مثل https://<name>.auth.didit.me، ولا تستخدم مفتاح API الخاص بـ Didit أبدًا.
معاملا الاستعلام step_up وstatus في return_to يشيران فقط إلى أن على تطبيقك الاستعلام عن الحالة. قبل اتخاذ أي إجراء، اقرأ خطوة المصادقة الإضافية باستخدام الحصول على خطوة المصادقة الإضافية، ولا تُكمل إلا عندما تكون قيمة status هي approved.

التفويضات

Authorization
string
header
مطلوب

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

الجسم

application/json

الإجراء الحساس الذي يوشك الشخص على اتخاذه.

action
enum<string>
مطلوب

payout (سحب أو تحويل)، أو bank (إضافة حساب بنكي أو تغييره)، أو contact (تغيير البريد الإلكتروني أو رقم الهاتف). تنطبق قاعدة الجهاز الجديد أيضاً على عمليات الدفع.

الخيارات المتاحة:
payout,
bank,
contact
return_to
string
مطلوب

المكان الذي يعود إليه الشخص بعد التحقق، مع إضافة step_up=<id>&status=approved. عند انطباق قاعدة معينة، يجب أن يكون أحد عناوين URI لإعادة التوجيه الخاصة بالتطبيق؛ وفي حال عدم انطباق أي قاعدة، لا يتم التحقق منه.

Maximum string length: 2048
مثال:

"https://app.example.com/payouts/confirm"

amount
string

مطلوب لـ payout: المبلغ، حتى منزلتين عشريتين. يُقبل أيضًا رقم بصيغة JSON.

Pattern: ^[0-9]{1,16}(\.[0-9]{1,2})?$
مثال:

"900.00"

currency
string

رمز ISO 4217 الخاص بـ amount. القيمة الافتراضية هي عملة قاعدة صرف الدفعات؛ ويُتحقَّق دائمًا من الدفعة المصروفة بعملة أخرى.

Pattern: ^[A-Z]{3}$
مثال:

"USD"

الاستجابة

لا تنطبق أي قاعدة.

لا تنطبق أي قاعدة: تابع تنفيذ الإجراء.

required
enum<boolean>
مطلوب
الخيارات المتاحة:
false
آخر تعديل في ٧ نوفمبر ٢٠٢٦