تحذيرات التوقيع الإلكتروني وأكواد المخاطر

تُصدِر خطوة التوقيع الإلكتروني تحذيراً عندما يتعذر على الموقّع التوقيع أو يرفضه: كأن يرفض التوقيع، أو تنفد الرموز لديه، أو يتعذر مطابقته مع هوية تم التحقق منها، أو لم يعد المستند يطابق ما عُرض عليه. يُوقف كل تحذير توقيع ذلك الموقّع، وبالتالي لا يُصدَر أي مستند موقّع له. ويعود إليك تحديد أثر التحذير على القرار.

نظرة عامة

يظهر التحذير في مكانين:

في عنصر الموقّع داخل signatures[]، على شكل { "code": "SIGNATURE_DECLINED", "node_id": "feature_signature" } داخل warnings[]. راجع تقرير التوقيع الإلكتروني.
في نشاط الجلسة، موسوماً بالميزة SIGNATURE، مع عنوانه ووصفه. تعرضه لوحة التحكم في تبويب التوقيع الخاص بالجلسة، ويشير additional_data.signature_id إلى الموقّع.

يرتبط كل رمز بقاعدة. يمكنك تعيين القاعدة إلى DECLINE أو REVIEW أو NO_ACTION لكل خطوة في سير العمل، من تبويب القواعد في لوحة التحكم أو في الإعدادات الخاصة بالخطوة. تحدد القاعدة verdict للموقّع (Declined أو In Review أو Approved) ودرجة خطورة التحذير (error أو warning أو information). وتُطبّق قواعد الحالة المخصصة في الخطوة بعد ذلك.

تحدد القاعدة القرار، وليس ما إذا كانت المستندات موقّعة أم لا. يتيح الخيار NO_ACTION لسير العمل الاستمرار، لكن الموقّع لم يوقّع بعد. تحقّق من أن status هو signed قبل الاعتماد على التوقيع.

التحذيرات الناتجة

الرمز	متى يُصدَر	القاعدة والإعداد الافتراضي
`SIGNATURE_DECLINED`	رفض الموقّع التوقيع. لا تُصدَر نسخة موقّعة ولا يُحتسب أي رسم.	`signature_declined_action`، الافتراضي `REVIEW`
`SIGNATURE_OTP_FAILED`	أدخل الموقّع 3 رموز خاطئة، أو طلب أكثر من 5 رموز.	`signature_otp_failed_action`، الافتراضي `DECLINE`
`SIGNATURE_NAME_MISMATCH`	KYB: الاسم المصرّح به للشخص الرئيسي لا يطابق اسمه الذي تم التحقق منه، مع تجاهل حالة الأحرف والمسافات.	`signature_name_mismatch_action`، الافتراضي `DECLINE`
`SIGNATURE_IDENTITY_NOT_VERIFIED`	ليس لدى الموقّع عملية تحقق من الهوية مقبولة تتضمن اسماً، أو أن فحص الحيوية في جلسته غير مقبول، أو تغيّر التحقق من الهوية بعد أن بدأ الموقّع.	`signature_identity_not_verified_action`، الافتراضي `DECLINE`
`SIGNATURE_DOCUMENT_CHANGED`	لم يعد المستند يطابق قيمة SHA-256 المسجلة عند عرضه على الموقّع.	`signature_document_changed_action`، الافتراضي `DECLINE`

تُجرى عمليات التحقق من الهوية والاسم عندما يطلب الموقّع رمزه ومرة أخرى عند إدخاله، لذا تظهر هذه التحذيرات عند هذه النقطة بدلاً من وقت فتح الخطوة.

يمكن إعادة فتح حالات الرفض

يُعدّ SIGNATURE_DECLINED التحذير الوحيد الذي يمكن للموقّع التراجع عنه. طالما أن رابط التوقيع صالح، يمكن للموقّع الذي رفض التوقيع إعادة فتح الخطوة والتوقيع. تؤدي إعادة الفتح إلى مسح تحذير الموقّع وقراءته وموافقته على كل مستند، بحيث يطّلع على المستندات مرة أخرى. يختفي التحذير من نشاط الجلسة بمجرد ألا يظل أي موقّع في الخطوة رافضاً للتوقيع. لا تعيد إعادة الفتح تعيين محاولات الرموز لديه. أما التحذيرات الأخرى فتكون نهائية لذلك الموقّع.

المشكلات التي تظهر للموقّع

تؤدي هذه المشكلات إلى إيقاف الموقّع دون إصدار تحذير. وتوضح له واجهة المسار ما حدث.

الحالة	ما يحدث
انتهاء صلاحية رابط التوقيع	يتعذر فتح الخطوة أو إكمالها بعد `expires_at`. يظل الرابط صالحاً لمدة `signature_link_validity_days` بدءاً من وقت إنشاء الجلسة.
انتهاء صلاحية الرمز	تظل الرموز صالحة لمدة 5 دقائق. ويطلب الموقّع رمزاً جديداً.
طُلب رمز جديد في وقت مبكر جداً	ينتظر الموقّع 60 ثانية بين كل طلب رمز وآخر.
عدم وجود وسيلة تواصل تم التحقق منها	يُرسل الرمز فقط إلى بريد إلكتروني أو رقم هاتف تم التحقق منه مسبقاً في الجلسة. أضف التحقق من البريد الإلكتروني أو التحقق من رقم الهاتف قبل خطوة التوقيع.
حقل مطلوب فارغ	يتعذر على الموقّع إنهاء المستند حتى تصبح لكل حقل مطلوب فيه قيمة. توضح واجهة المسار عدد الحقول المتبقية وتنتقل مباشرة إلى أول حقل منها.
رُفضت قيمة الحقل	تُرفض أي قيمة تنتهك التحقق من صحة الحقل الخاص بها، كأن تكون طويلة جداً أو ليست رقماً، وتوضح واجهة المسار سبب ذلك.
التطبيق قديم جداً بالنسبة للحقول	يتعذر على إصدار SDK أصلي لا يدعم الحقول عرض مستند يحتوي على حقول، وتُظهر الخطوة خطأً. تظل المستندات التي لا تحتوي على حقول تعمل دون مشكلة. راجع تجربة التوقيع.

مثال

{
  "signatures": [
    {
      "id": "0e6c2a8e-6c2f-4b8e-9a51-3f2f6a7d9b10",
      "node_id": "feature_signature",
      "status": "declined",
      "verdict": "In Review",
      "warnings": [
        { "code": "SIGNATURE_DECLINED", "node_id": "feature_signature" }
      ],
      "declined_at": "2026-11-03T10:41:40.320Z",
      "declined_action": "REVIEW",
      "signed_at": null,
      "certificate": null,
      "timestamp": null,
      "evidence_file": null
    }
  ]
}

يُظهر المثال الحقول التي تتغير فقط. وتظل جميع الحقول الأخرى في كائن التوقيع موجودة.

أنواع التحذيرات

تتبع درجة خطورة كل تحذير القاعدة التي تحددها. وتندرج درجات الخطورة تحت ثلاث فئات:

المصادقة

التحقق

المراقبة

المنصة

تحذيرات التوقيع الإلكتروني وأكواد المخاطر

نظرة عامة

التحذيرات الناتجة

يمكن إعادة فتح حالات الرفض

المشكلات التي تظهر للموقّع

مثال

أنواع التحذيرات

ذات صلة

​نظرة عامة

​التحذيرات الناتجة

​يمكن إعادة فتح حالات الرفض

​المشكلات التي تظهر للموقّع

​مثال

​أنواع التحذيرات

​ذات صلة

نظرة عامة

التحذيرات الناتجة

يمكن إعادة فتح حالات الرفض

المشكلات التي تظهر للموقّع

مثال

أنواع التحذيرات

ذات صلة