الحصول على إعدادات Travel Rule: ملف VASP

curl

curl -X GET https://verification.didit.me/v3/travel-rule/settings/ \
  -H 'x-api-key: YOUR_API_KEY'

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY.
using var client = new DiditClient();

var result = await client.TravelRule.RetrieveSettingsAsync();
Console.WriteLine(JsonSerializer.Serialize(result));

{
  "is_enabled": false,
  "jurisdiction": "EU",
  "name_matching_strictness": "DEFAULT",
  "confirmation_timeout_hours": 48,
  "timeout_outcome": "HOLD",
  "threshold_amount": "0.00",
  "inbound_auto_accept": true,
  "allow_self_declaration": true,
  "allow_screenshot_proof": true,
  "auto_wallet_verification": true,
  "vasp_attribution_enabled": true,
  "legal_name": "",
  "lei": "",
  "compliance_email": "",
  "is_discoverable": true,
  "counterparty_screening_enabled": false,
  "sunrise_policy": "",
  "sunrise_jurisdictions": [
    "CO",
    "KH",
    "VN"
  ],
  "non_responsive_policy": "",
  "travel_address": "",
  "disabled_networks": [],
  "networks": {
    "gtr": {
      "rail": "GTR",
      "mode": "unavailable",
      "state": "didit_onboarding",
      "reason": "didit_membership_not_live",
      "platform_available": false,
      "connected": false,
      "participant": null,
      "vasps_reachable": 0,
      "routed_30d": 0
    },
    "trust": {
      "rail": "TRUST",
      "mode": "unavailable",
      "state": "unavailable",
      "reason": "own_membership_only",
      "platform_available": false,
      "connected": false,
      "participant": null,
      "vasps_reachable": 0,
      "routed_30d": 0
    },
    "verifyvasp": {
      "rail": "VERIFYVASP",
      "mode": "unavailable",
      "state": "didit_onboarding",
      "reason": "didit_membership_not_live",
      "platform_available": false,
      "connected": false,
      "participant": null,
      "vasps_reachable": 0,
      "routed_30d": 0
    },
    "sygna": {
      "rail": "SYGNA",
      "mode": "unavailable",
      "state": "didit_onboarding",
      "reason": "didit_membership_not_live",
      "platform_available": false,
      "connected": false,
      "participant": null,
      "vasps_reachable": 0,
      "routed_30d": 0
    }
  },
  "didit_network": {
    "listed": false,
    "missing": [
      "travel_rule_off",
      "legal_name_missing",
      "compliance_email_missing"
    ],
    "compliance_email_confirmed": false
  }
}

GET

travel-rule

settings

curl

curl -X GET https://verification.didit.me/v3/travel-rule/settings/ \
  -H 'x-api-key: YOUR_API_KEY'

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY.
using var client = new DiditClient();

var result = await client.TravelRule.RetrieveSettingsAsync();
Console.WriteLine(JsonSerializer.Serialize(result));

{
  "is_enabled": false,
  "jurisdiction": "EU",
  "name_matching_strictness": "DEFAULT",
  "confirmation_timeout_hours": 48,
  "timeout_outcome": "HOLD",
  "threshold_amount": "0.00",
  "inbound_auto_accept": true,
  "allow_self_declaration": true,
  "allow_screenshot_proof": true,
  "auto_wallet_verification": true,
  "vasp_attribution_enabled": true,
  "legal_name": "",
  "lei": "",
  "compliance_email": "",
  "is_discoverable": true,
  "counterparty_screening_enabled": false,
  "sunrise_policy": "",
  "sunrise_jurisdictions": [
    "CO",
    "KH",
    "VN"
  ],
  "non_responsive_policy": "",
  "travel_address": "",
  "disabled_networks": [],
  "networks": {
    "gtr": {
      "rail": "GTR",
      "mode": "unavailable",
      "state": "didit_onboarding",
      "reason": "didit_membership_not_live",
      "platform_available": false,
      "connected": false,
      "participant": null,
      "vasps_reachable": 0,
      "routed_30d": 0
    },
    "trust": {
      "rail": "TRUST",
      "mode": "unavailable",
      "state": "unavailable",
      "reason": "own_membership_only",
      "platform_available": false,
      "connected": false,
      "participant": null,
      "vasps_reachable": 0,
      "routed_30d": 0
    },
    "verifyvasp": {
      "rail": "VERIFYVASP",
      "mode": "unavailable",
      "state": "didit_onboarding",
      "reason": "didit_membership_not_live",
      "platform_available": false,
      "connected": false,
      "participant": null,
      "vasps_reachable": 0,
      "routed_30d": 0
    },
    "sygna": {
      "rail": "SYGNA",
      "mode": "unavailable",
      "state": "didit_onboarding",
      "reason": "didit_membership_not_live",
      "platform_available": false,
      "connected": false,
      "participant": null,
      "vasps_reachable": 0,
      "routed_30d": 0
    }
  },
  "didit_network": {
    "listed": false,
    "missing": [
      "travel_rule_off",
      "legal_name_missing",
      "compliance_email_missing"
    ],
    "compliance_email_confirmed": false
  }
}

توفر الشبكات

تتطلب GTR وTRUST وVerifyVASP وSygna جميعها عضوية نشطة. لا تملك Didit حالياً عضوية منصة في أي من هذه الشبكات، فهي في طور التسجيل كمزوّد. إلى أن يحدث ذلك، لا يُوجَّه مسار الشبكة إلا عبر عضويتك أنت، المتصلة عبر Marketplace. اقرأ networks للتطبيق الذي تقوم بإعداده:

own - تتقدّم عضويتك المتصلة على غيرها، حتى لو كانت الشبكة مدرجة في disabled_networks. تستخدم عمليات التبادل هوية شبكتك.
didit - تحمل عضوية Didit تطبيقك بوصفه مشاركاً نشطاً خاصاً به على هذه الشبكة، باستخدام الرمز الذي منحتك إياه الشبكة. لا تحتاج هذه الشبكة إلى بيانات اعتماد عضوية العميل. للوصول إلى هذا الوضع، يلزم استبيان شبكة Didit وطلب إلى الشبكة: انظر الحصول على شبكات Travel Rule. لا تُبلّغ بيئة الإنتاج عن هذا الوضع بعد، لأن عضوية Didit الخاصة بالشبكة غير عاملة.
off - عطّلت التوجيه عبر المنصة ولا توجد عضوية متصلة خاصة بك. أزل الشبكة من disabled_networks للسماح بالتوجيه عبر المنصة عند توفره، أو اربط عضويتك الخاصة.
unavailable - لا يمكن إرسال أي شيء عبر هذه الشبكة لتطبيقك حتى الآن. يوضح state وreason السبب، فمثلاً didit_onboarding تعني أن عضوية Didit في الشبكة غير مفعّلة، وquestionnaire_needed تعني أن استبيانك لم يُعتمد بعد. يُبلَّغ عن كل شبكة بهذا الوضع حالياً ما لم تربط عضويتك الخاصة أو تعطّل الشبكة. اربط عضويتك الخاصة في Marketplace، أو استخدم طرفاً مقابلاً متاحاً من النوع INTERNAL أو TRP أو EMAIL.

لا تؤثر disabled_networks إلا في عضوية Didit على المنصة، وهي غير متاحة بعد، لذلك ليس لها أي أثر على التوجيه حالياً. يُختار مسار الشبكة عندما يحمل beneficiary_data الخاص بالتحويل معرّف الطرف المقابل على تلك الشبكة (مثلاً counterparty_gtr_vasp_code أو counterparty_trust_membership_id)، أو عندما يدرج الإدخال الخاص بالطرف المقابل في الدليل الشبكةَ تحت رمز على تلك الشبكة. في GTR وVerifyVASP وSygna، تقرأ Didit رد الطرف المقابل من استجابة الشبكة، أو عبر استطلاع الشبكة كل 5 دقائق، فينتقل التحويل إلى COMPLETED أو COUNTERPARTY_MISMATCHED_DATA أو COUNTERPARTY_VASP_GENERAL_DECLINE. تتيح TRUST الإرسال فقط. يبقى التحويل المُرسل عبرها في AWAITING_COUNTERPARTY حتى تنقضي confirmation_timeout_hours، فيصبح EXPIRED، وعندها يُطبَّق timeout_outcome. إذا تعذّر تسليم الرسالة، ينتقل التحويل إلى COUNTERPARTY_VASP_NOT_REACHABLE بدلاً من ذلك. راجع شبكات Travel Rule لمعرفة ما تصل إليه كل شبكة اليوم. platform_available حالة إعداد، وليس فحصاً حياً لصحة الشبكة. يُبلّغ connected عن عضوية محفوظة اجتازت التحقق المحلي من بيانات الاعتماد، وليس عن تبادل ناجح مع المزوّد. تفعيل is_enabled أو مسح disabled_networks لا يمكن أن يوفّر عضوية مفقودة. للفحوص التي يمكنك تشغيلها دون بيانات اعتماد الشبكة، راجع الاختبار دون بيانات اعتماد الشبكة.

التفويضات

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.

الاستجابة

200 - application/json

إعدادات Travel Rule وملف تعريف VASP الحاليان.

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، يقبل التحويل الذي يقل عن هذا المبلغ (بعملة الحد) إقراراً ذاتياً. ويُعتبر التحويل الذي لا يحتوي على مبلغ بتلك العملة أعلى منه.

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

Show child attributes

matching_rules

object

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

Show child attributes

legal_name

string

الاسم القانوني لمؤسسة 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 في تلك الشبكة ونشاط مشاركك الخاص عليها. ليس فحصاً مباشراً لحالة التشغيل أو التسليم.

Show child attributes

didit_network

object

read-only

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

Show child attributes

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

​توفر الشبكات

التفويضات

الاستجابة

توفر الشبكات