وثائق KYC ودورة حياة ملف الامتثال
الأسواق المنظَّمة لا تقبل «ثق بي» — فالمشغّل أو الجهة التنظيمية يطلبان إثباتًا على هويتك قبل السماح بتفعيل رقم هاتف أو نقل حركة هوية مرسل. تُنمذج Orbit ذلك الإثبات كشيئين تملكهما: مكتبة وثائق (الملفات نفسها) وملفات امتثال (الهوية المنظَّمة التي تدعمها الوثائق). تشرح هذه الصفحة ما يلتقطه الملف، وكيف تنتقل الوثائق من الرفع إلى إعادة الاستخدام إلى التجديد، وأين يُرجَع إلى الوثيقة نفسها، وكيف تَرى انقضاءً قادمًا قبل أن يكلّفك رقمًا. جميع نقاط النهاية أدناه متجذّرة فيhttps://api.orbit.devotel.io/api/v1/compliance.
تخزّن Orbit وثائقك، وتنقلها إلى المشغّل، وتُظهِر وضعية مراجعتها — الموافقة
النهائية تُمنَح دائمًا من المشغّل أو الجهة التنظيمية في كل بلد، وليس من
المنصّة. أما توريد الوثائق وتجديدها فيبقى عليك.
ما هو ملف الامتثال
ملف الامتثال (cprof_…) هو حِزمة هوية تنظيمية واحدة: مَن المستخدم
النهائي، ولأي حالة استخدام، وفي أيّ بلد. يراجع المشغّلون الملف كوحدة —
وعند موافقته مرة واحدة، يمكن لكل رقم أو مرسِل يغطّيه ذلك الملف استخدامه.
تنقل وضعية الملف نفسه
draft → pending_review → approved (أو
rejected / partially_rejected)، وإلى expired عند إغلاق نافذة صلاحيته.
وحدها وضعية approved تستوفي فحوصات البلد.
دورة حياة الوثيقة
تعيش الوثائق في مكتبة على مستوى المستأجر، منفصلة عن أي ملف منفرد. ارفع جواز سفر مرة واحدة ويمكنك إلحاقه بملف أرقام ألماني اليوم وإعادة استخدام الملف نفسه لتسجيل هوية مرسِل غدًا — بلا رفع ثانٍ.1. الرفع
يستقبلPOST /compliance/documents رفع multipart/form-data ويعيد
معرّف المكتبة للوثيقة، والذي يبدأ دائمًا بـ doc_:
تُشفَّر الملفات قبل مغادرتها واجهة API وتُحفَظ في تخزين خاص؛ ولا شيء في
معرّف
doc_… قابل للتخمين أو المشاركة خارج منظمتك. اِسرد المكتبة في أي
وقت عبر GET /compliance/documents.
2. المرجع بمعرّف doc_…
الوثيقة وحدها خاملة — لا تؤدّي عملًا تنظيميًا إلا حين تكون ملحقة بملف
بدور:
id_proof، address_proof، business_doc، authorization،
other) المشغّل أيَّ متطلب تستوفي الوثيقة. وقد يلعب معرّف doc_… نفسه
دورًا مختلفًا في ملف مختلف.
3. الانقضاء
تعتبر كثير من الجهات التنظيمية الوثائق قديمة بعد عمر محدد — فـ Ofcom في المملكة المتحدة وBNetzA في ألمانيا وARCEP في فرنسا، من بين جهات أخرى، تشترط عمومًا ألا يتجاوز عمر إثبات الهوية أو العنوان 3–12 شهرًا. تسجّل Orbit قيمةexpires_at لكل وثيقة ملحقة؛ وما إن تنقضي الوثيقة حتى تتوقف عن
الاحتساب ضمن متطلبات البلد، وإن بقي الملف نفسه في مكتبتك.
4. التجديد
التجديد رفع جديد، لا تحرير: ارفع الوثيقة البديلة، وألحِقها بالملف في الدور نفسه، ثم افصِل (واحذف اختياريًا، عبرDELETE /compliance/documents/:id)
الوثيقة المنقضية. تبقى الملفات في وضعية approved موافق عليها حيال تبديلك
الوثيقة — ويُعاد مراجعة التسليم في الاستخدام التالي.
أين تُعاد استخدام الوثائق
معرّفdoc_… هو المؤشر الوحيد الذي تتشاركه ثلاثة أسطح منتج:
- تسجيل هوية المرسل. يحمل كل إدخال بلد في
تسجيل هوية المرسل حقل
document_refs: قائمة معرّفاتdoc_…الداعمة لملف ذلك البلد. لا يقبل مسار التسجيل ملفات أبدًا — اِرجِع إلى معرّفات المكتبة التي رفعتها سلفًا، وتدعم الوثيقة نفسها أي عدد من البلدان التي تقبلها. - المعاينة التنظيمية للأرقام. يعيد فحص
المعاينة التنظيمية
compliance_profile_satisfies: trueفقط حين يغطّي ملفٌّ كل حقل مطلوب وتكون وثائقه الملحقة غير منقضية — ووثيقة منقضية تقلب العلامة إلىfalseحتى على ملف مكتمل بخلاف ذلك. - بوّابة شراء الأرقام. شراء رقم في بلد منظَّم دون ملف مُستوفٍ يهبط
الرقم عند
pending_compliance: يُخصَم، لكنه لا يتفعّل حتى يُلحَق ملف موافَق عليه. وإذا انقضت مهلة التحقق من المشغّل بينما الرقم ما زال منتظرًا، قد يُحرَّر الرقم تلقائيًا — راجع دورة حياة الرقم للتحرير والاسترجاع.
راقب الانقضاء قبل أن يكلّفك رقمًا
تشتقّ Orbit تنبيهات الانقضاء لكل رقم من الطوابع الزمنية التي تخزّنها أصلًا:expires_at لكل وثيقة، ومهلة التحقق من المشغّل على الأرقام المنتظرة عند
pending_compliance. اقرأها بـ:
earliest_expiry_at)، وما إذا كان
مصدره وثيقة أم مهلة المشغّل (earliest_expiry_source)، وعدد الأيام الكاملة
حتى الانقضاء (سالبة بمجرد حدوثه)، وsuggested_action:
renew— ما زال صالحًا لكنه داخل نافذة تنبيهك؛ ارفع البديل الآن.renew_or_release— انقضى بالفعل؛ جدّد فورًا أو اقرّر التخلي عن الرقم.
numbers.document_expiry_alert_days (1–365 يومًا)، أو عاين نافذة مختلفة
مؤقتًا عبر معامِل الاستعلام ?days=. صفوف الاستجابة مُرتَّبة بحسب الأكثر
إلحاحًا أولاً؛ وتُقطَع قائمة مُعرَّضة كبيرة جدًا عند السقف وتُبلِغ
truncated: true، فضيّق النافذة إذا بلغت السقف.
مملوك للمستأجر بحكم التصميم
تقسيم المسؤولية مقصود:
لا تختلق Orbit وثائق هوية نيابة عنك ولا تُجدّدها تلقائيًا — الجهة التنظيمية
تتحقق من هويّتك أنت، فكل تجديد يبدأ دائمًا برفع جديد منك. ما تضمنه
المنصّة هو أنّ وثيقة توردها مرة واحدة قابلة لإعادة الاستخدام في كل موضع
تُقبَل فيه، وأنك سترى انقضاءها قادمًا مع مهلة كافية للتصرّف.
مراجع ذات صلة
- تسجيل هوية المرسل — تسجيل لكل بلد
مدعوم بـ
document_refs. - المعاينة التنظيمية — تحقّق من الحقول والوثائق التي يشترطها بلد ما قبل الشراء.
- دورة حياة الرقم — ما يحدث لرقم عالق عند
pending_compliance، والتحرير/الاسترجاع. - متطلبات امتثال البلدان — أي أنواع مرسلين ووثائق يقبلها كل بلد.
- مرجع API → الامتثال — مخططات الطلب/الاستجابة الكاملة.