الانتقال إلى المحتوى الرئيسي
PUT
curl

التفويضات

x-api-key
string
header
مطلوب

مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console. يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير 404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع https://docs.didit.me/console/api-keys.

الجسم

application/json

جميع الحقول اختيارية؛ يُطبّق PUT تحديثاً جزئياً.

is_enabled
boolean
Maximum string length: 255
lei
string
Maximum string length: 20
jurisdiction
string
Maximum string length: 8
name_matching_strictness
enum<string>

يقبل CONTAINS اسماً تظهر جميع كلماته في الاسم الآخر.

الخيارات المتاحة:
NONE,
STRICT,
CONTAINS,
DEFAULT,
FUZZY
confirmation_timeout_hours
integer
النطاق المطلوب: x >= 1
timeout_outcome
enum<string>
الخيارات المتاحة:
HOLD,
REJECT,
PROCEED
compliance_email
string<email>

البريد الإلكتروني لجهة اتصال الامتثال لملف VASP التعريفي الخاص بك. تدرج شبكة Didit ملفك التعريفي فقط بمجرد تأكيد هذا العنوان عبر رابط مرسل بالبريد الإلكتروني (POST /v3/travel-rule/settings/compliance-email/confirmation/)؛ ويتطلب تغييره تأكيداً جديداً.

is_discoverable
boolean

ما إذا كان يمكن إدراج ملف تعريف VASP الخاص بك في شبكة Didit: يتم العثور عليه في GET /v3/travel-rule/vasps/ بواسطة عملاء Didit الآخرين والوصول إليه عبر مسار INTERNAL. يتطلب الإدراج أيضاً تطبيقاً قيد الإنتاج، وتفعيل Travel Rule، واسماً قانونياً، وبريداً إلكترونياً مؤكداً للامتثال؛ يوضح didit_network العناصر المفقودة. القيمة الافتراضية هي true.

threshold_amount
string

سلسلة نصية عشرية، صفر أو أكثر، بالعملة الافتراضية لتطبيقك. الحد الأدنى لمبلغ التحويل الذي يُشغّل التبادل المُدار.

ownership_validation_mode
enum<string>

انظر حقل الاستجابة الذي يحمل الاسم نفسه.

الخيارات المتاحة:
FULL,
SIMPLIFIED,
AUTOMATED
simplified_validation_threshold
string

سلسلة نصية عشرية، 0 أو أكثر.

data_sharing_fields
object

يتم الدمج حسب نوع الكيان: أي نوع كيان تستبعده يحتفظ باختياره الحالي. الاختيار الذي لا يمكنه تلبية التزامات المُرسِل لنظام jurisdiction الخاص بك (EU TFR أو توصية FATF رقم 16)، بما في ذلك القائمة الفارغة، يتم رفضه بالرمز 400.

matching_rules
object

يتم الدمج حسب نوع الكيان، وحسب الحقل داخله. الحقل الذي لا يقارنه نوع الكيان هذا (على سبيل المثال date_of_birth لـ company) يتم رفضه بالرمز 400.

inbound_auto_accept
boolean
allow_self_declaration
boolean
allow_screenshot_proof
boolean

عند التعيين على true، توفر أداة ملكية المحفظة خيار تحميل لقطة شاشة كطريقة لإثبات الملكية. القيمة الافتراضية هي true.

auto_wallet_verification
boolean
vasp_attribution_enabled
boolean
counterparty_screening_enabled
boolean

فحص اختياري للعقوبات والأخبار السلبية لجهات VASP التابعة للطرف المقابل، وتتم الفوترة لكل فحص بسعر فحص AML للشركات. عند تفعيله، تفحص Didit الطرف المقابل الذي يبلغه تبادل صادر (مع إعادة استخدام فحص أُجري منذ أقل من 30 يوماً) ويمكنك فحص إحداها عبر POST /v3/travel-rule/vasps/{vasp_id}/screening/. القيمة الافتراضية false: لا يتم فحص أي شيء ولا تتم الفوترة.

sunrise_policy
enum<string>

HOLD أو REJECT أو PROCEED، أو فارغ لاتباع timeout_outcome. راجع حقل الاستجابة الذي يحمل نفس الاسم.

الخيارات المتاحة:
,
HOLD,
REJECT,
PROCEED
non_responsive_policy
enum<string>

HOLD أو REJECT أو PROCEED، أو فارغ لاتباع timeout_outcome. راجع حقل الاستجابة الذي يحمل نفس الاسم.

الخيارات المتاحة:
,
HOLD,
REJECT,
PROCEED
disabled_networks
enum<string>[]

الشبكات المنسحبة من عضوية المنصة. لا يؤدي ذلك إلى تعطيل عضوياتك الخاصة المتصلة أو توفير شبكات غير متاحة.

الخيارات المتاحة:
GTR,
TRUST,
VERIFYVASP,
SYGNA

الاستجابة

الإعدادات والملف التعريفي بعد التحديث، بنفس بنية GET.

is_enabled
boolean

ما إذا كان سير عمل تفاوض Travel Rule المُدار نشطاً لمعاملات travelRule الصادرة في هذا التطبيق.

jurisdiction
string

كود الولاية القضائية التشغيلية الخاصة بـ VASP لديك. القيمة الافتراضية "EU". تقوم Didit بمطابقته مع النظام الذي تدمغه على معاملات Travel Rule الخاصة بك كـ travel_rule_regime (على سبيل المثال، يتحول EU أو كود دولة عضو في الاتحاد الأوروبي إلى eu)، والذي يمكن لقواعد المعاملات الاستناد إليه. يراه عملاء Didit الآخرون باعتباره ولايتك القضائية في دليل VASP بمجرد أن تُدرج شبكة Didit ملفك التعريفي.

Maximum string length: 8
name_matching_strictness
enum<string>

مدى دقة مطابقة أسماء المستفيدين المطلوبة قبل أن تصل المعاملة إلى حالة COMPLETED. تقبل CONTAINS اسماً تظهر جميع كلماته في الاسم الآخر.

الخيارات المتاحة:
NONE,
STRICT,
CONTAINS,
DEFAULT,
FUZZY
confirmation_timeout_hours
integer

الساعات التي يجوز خلالها أن تظل معاملة AWAITING_COUNTERPARTY غير مؤكدة قبل أن تُنهي أداة المسح الدورية صلاحيتها. القيمة الافتراضية 48.

النطاق المطلوب: x >= 1
timeout_outcome
enum<string>

ما يحدث للمعاملة الأساسية عند انتهاء صلاحية التحويل. القيمة الافتراضية HOLD. تكون لـ sunrise_policy وnon_responsive_policy الأولوية عند انطباقهما وتعيينهما.

الخيارات المتاحة:
HOLD,
REJECT,
PROCEED
threshold_amount
string

سلسلة نصية عشرية، بالعملة الافتراضية لتطبيقك. الحد الأدنى لمبلغ التحويل الذي يُشغّل التبادل المُدار؛ التحويلات الأقل منه تُحسم مباشرة إلى NOT_APPLICABLE. تقارن Didit مبلغ المعاملة محولاً إلى عملتك الافتراضية، أو قيمة amount_in_default_currency التي ترسلها؛ وعند عدم توفر مبلغ محوّل، لا يُطبّق الحد. القيمة الافتراضية هي "0.00" (لا تفرض لائحة TFR في الاتحاد الأوروبي حداً أدنى للمبلغ).

ownership_validation_mode
enum<string>

مقدار الإثبات الذي تتطلبه ملكية المحفظة. تتطلب FULL دائماً إثباتاً (رسالة موقعة، أو إيداعاً تجريبياً، أو لقطة شاشة تمت مراجعتها)، ولا تقبل مطلقاً مجرد إقرار المستخدم النهائي. تقبل SIMPLIFIED إقراراً ذاتياً تحت قيمة simplified_validation_threshold وإثباتاً فوقها. تتيح AUTOMATED لدفتر العناوين والإثباتات السابقة الإجابة تلقائياً، بما في ذلك الإقرارات الذاتية طالما أن allow_self_declaration مضبوطة على true. القيمة الافتراضية هي AUTOMATED.

الخيارات المتاحة:
FULL,
SIMPLIFIED,
AUTOMATED
simplified_validation_threshold
string

سلسلة نصية عشرية، القيمة الافتراضية "0.00". في وضع SIMPLIFIED، يقبل التحويل الذي يقل عن هذا المبلغ (بعملة الحد) إقراراً ذاتياً. ويُعتبر التحويل الذي لا يحتوي على مبلغ بتلك العملة أعلى منه.

data_sharing_fields
object

الحقول التي ترسلها Didit إلى VASP للطرف المقابل حول المستخدمين لديك، لكل نوع كيان. يتم إرسال name وwallet_address دائماً بغض النظر عما تحدده القائمة. نوع الكيان الذي لم تختَره مطلقاً يشارك كل الحقول. كما أن القائمة الفارغة تُعد خياراً أيضاً: حيث تشارك الاسم والمحفظة فقط.

matching_rules
object

مدى دقة مقارنة كل حقل من بيانات الطرف المقابل مع ما تحتفظ به، لكل نوع جهة. يحتفظ الحقل الذي تتركه بقيمته الافتراضية. تتخطى NONE المقارنة، وتتطلب STRICT نفس الكلمات تماماً، وتقبل CONTAINS قيمة واحدة تظهر جميع كلماتها في القيمة الأخرى، وتعتمد DEFAULT المطابقة الجزئية القياسية، بينما تقبل FUZZY التهجئات المتقاربة (ولتواريخ الميلاد، تبديل اليوم والشهر).

الاسم القانوني لمؤسسة VASP الخاصة بك. مطلوب (غير فارغ) لتعيين is_enabled إلى true.

lei
string

معرّف الكيان القانوني الخاص بك، المعروض في دليل VASP.

compliance_email
string<email>

البريد الإلكتروني لجهة اتصال الامتثال لملف VASP التعريفي الخاص بك. تدرج شبكة Didit ملفك التعريفي فقط بمجرد تأكيد هذا العنوان عبر رابط مرسل بالبريد الإلكتروني (POST /v3/travel-rule/settings/compliance-email/confirmation/)؛ ويتطلب تغييره تأكيداً جديداً.

is_discoverable
boolean

ما إذا كان يمكن إدراج ملف تعريف VASP الخاص بك في شبكة Didit: يتم العثور عليه في GET /v3/travel-rule/vasps/ بواسطة عملاء Didit الآخرين والوصول إليه عبر مسار INTERNAL. يتطلب الإدراج أيضاً تطبيقاً قيد الإنتاج، وتفعيل Travel Rule، واسماً قانونياً، وبريداً إلكترونياً مؤكداً للامتثال؛ يوضح didit_network العناصر المفقودة. القيمة الافتراضية هي true.

inbound_auto_accept
boolean

عند التعيين على true، تتم الموافقة تلقائياً على استفسار TRP الوارد الذي تكون فيه محفظة المستفيد مُدخلةً موثقةً في دفتر العناوين مع تطابق الاسم. وعند التعيين على false، ينتظر ذلك الاستفسار في حالة ON_HOLD حتى توافق عليه أو ترفضه عبر endpoint الخاص بالملكية. لا تتأثر تحويلات مسار INTERNAL والتحويلات بعد الإيداع. القيمة الافتراضية هي true.

allow_self_declaration
boolean

عند التعيين على true، توفر أداة ملكية المحفظة خيار الإقرار الذاتي كطريقة إثبات احتياطية. القيمة الافتراضية هي true.

allow_screenshot_proof
boolean

عند التعيين على true، توفر أداة ملكية المحفظة خيار تحميل لقطة شاشة كطريقة لإثبات الملكية. القيمة الافتراضية هي true.

auto_wallet_verification
boolean

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

vasp_attribution_enabled
boolean

عند التعيين على true، يُنسَب تحويل Travel Rule الصادر الذي يتعذر على أي مسار توجيهه عبر تحليلات البلوكتشين: يتم تحديد الـ VASP المالك لمحفظة الوجهة، ويُسجَّل الكيان في التحويل ودليل VASP، وتتم إعادة تشغيل المسارات مرة واحدة بالاسم المنسوب. القيمة الافتراضية هي true.

counterparty_screening_enabled
boolean

فحص اختياري للعقوبات والأخبار السلبية لجهات VASP التابعة للطرف المقابل، وتتم الفوترة لكل فحص بسعر فحص AML للشركات. عند تفعيله، تفحص Didit الطرف المقابل الذي يبلغه تبادل صادر (مع إعادة استخدام فحص أُجري منذ أقل من 30 يوماً) ويمكنك فحص إحداها عبر POST /v3/travel-rule/vasps/{vasp_id}/screening/. القيمة الافتراضية false: لا يتم فحص أي شيء ولا تتم الفوترة.

sunrise_policy
enum<string>

ما يفعله التحويل منتهي الصلاحية بمعاملته عندما يكون الطرف المقابل إدخال دليل في اختصاص قضائي مدرج ضمن sunrise_jurisdictions ولا يطبق Travel Rule بعد: HOLD ينقله إلى المراجعة، وREJECT يرفضه، وPROCEED يترك حالته دون تغيير. القيمة الفارغة (الافتراضية) تتبع timeout_outcome. يُطبّق قبل non_responsive_policy.

الخيارات المتاحة:
,
HOLD,
REJECT,
PROCEED
sunrise_jurisdictions
string[]
read-only

للقراءة فقط. الدول (ISO 3166 alpha-2) التي تعاملها Didit على أنها في فترة بداية تطبيق Travel Rule، حيث ينطبق sunrise_policy. حالياً CO و KH و VN. أي اختصاص قضائي آخر، أو إذا كان فارغاً أو غير معروف، يتبع timeout_outcome.

non_responsive_policy
enum<string>

ما يفعله التحويل منتهي الصلاحية بمعاملته عندما يكون الطرف المقابل إدخال دليل تكون حالة استجابته UNRESPONSIVE: إما HOLD أو REJECT أو PROCEED، كما هو الحال بالنسبة لـ timeout_outcome. القيمة الفارغة (الافتراضية) تتبع timeout_outcome. يُطبّق sunrise_policy أولاً عندما ينطبق كلاهما.

الخيارات المتاحة:
,
HOLD,
REJECT,
PROCEED
travel_address
string

للقراءة فقط. Travel Address الخاص بـ VASP لديك - endpoint استعلام TRP الوارد المُرمَّز الذي تستخدمه جهات VASP الأخرى للوصول إليك. يكون فارغاً طالما أن is_enabled بقيمة false.

disabled_networks
enum<string>[]

الشبكات المنسحبة من عضوية المنصة. لا يؤدي ذلك إلى تعطيل عضوياتك الخاصة المتصلة أو توفير شبكات غير متاحة.

الخيارات المتاحة:
GTR,
TRUST,
VERIFYVASP,
SYGNA
networks
object
read-only

حسب الشبكة، كيف سيرسل هذا التطبيق ولماذا يتعذر عليه ذلك. لا يتم تضمين أي شبكة، بما في ذلك GTR، افتراضياً: يمكن الوصول إلى الشبكة من خلال عضويتك المتصلة الخاصة، أو من خلال عضوية Didit بمجرد تفعيل عضوية Didit في تلك الشبكة ونشاط مشاركك الخاص عليها. ليس فحصاً مباشراً لحالة التشغيل أو التسليم.

didit_network
object
read-only

ما إذا كانت شبكة Didit تُدرج ملف VASP التعريفي الخاص بك، بحيث يعثر عليه عملاء Didit الآخرون في الدليل ويصلون إليه عبر مسار INTERNAL، وكل شرط لم يستوفه بعد.

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