curl --request POST \
--url https://{issuer}/step-up/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"action": "payout",
"amount": "900.00",
"currency": "USD",
"return_to": "https://app.example.com/payouts/confirm"
}
'{
"required": false
}إنشاء التحقق الإضافي (Step-Up) | Didit Authentication API
يطبّق POST /step-up/ من Didit قواعد التحقق الإضافي الخاصة بك قبل أي إجراء حساس. يعيد required false، أو رابط تحقق موجّه للشخص.
curl --request POST \
--url https://{issuer}/step-up/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"action": "payout",
"amount": "900.00",
"currency": "USD",
"return_to": "https://app.example.com/payouts/confirm"
}
'{
"required": false
}https://<name>.auth.didit.me، ولا تستخدم مفتاح API الخاص بـ Didit أبدًا.step_up وstatus في return_to يشيران فقط إلى أن على تطبيقك الاستعلام عن الحالة. قبل اتخاذ أي إجراء، اقرأ خطوة المصادقة الإضافية باستخدام الحصول على خطوة المصادقة الإضافية، ولا تُكمل إلا عندما تكون قيمة status هي approved.التفويضات
token الوصول الخاص بالشخص من POST /token/: عبارة عن ES256 JWT برأس typ: at+jwt، صالح لمدة 5 دقائق كحد أقصى. ليس مفتاح API الخاص بك في Didit.
الجسم
الإجراء الحساس الذي يوشك الشخص على اتخاذه.
payout (سحب أو تحويل)، أو bank (إضافة حساب بنكي أو تغييره)، أو contact (تغيير البريد الإلكتروني أو رقم الهاتف). تنطبق قاعدة الجهاز الجديد أيضاً على عمليات الدفع.
payout, bank, contact المكان الذي يعود إليه الشخص بعد التحقق، مع إضافة step_up=<id>&status=approved. عند انطباق قاعدة معينة، يجب أن يكون أحد عناوين URI لإعادة التوجيه الخاصة بالتطبيق؛ وفي حال عدم انطباق أي قاعدة، لا يتم التحقق منه.
2048"https://app.example.com/payouts/confirm"
مطلوب لـ payout: المبلغ، حتى منزلتين عشريتين. يُقبل أيضًا رقم بصيغة JSON.
^[0-9]{1,16}(\.[0-9]{1,2})?$"900.00"
رمز ISO 4217 الخاص بـ amount. القيمة الافتراضية هي عملة قاعدة صرف الدفعات؛ ويُتحقَّق دائمًا من الدفعة المصروفة بعملة أخرى.
^[A-Z]{3}$"USD"
الاستجابة
لا تنطبق أي قاعدة.
لا تنطبق أي قاعدة: تابع تنفيذ الإجراء.
false