INTERNAL بين عميلين لدى Didit، وبروتوكول Travel Rule المفتوح (TRP)، وEMAIL. أما المسارات الأربعة للشبكات (GTR وTRUST وVERIFYVASP وSYGNA) فتتطلب عضوية في تلك الشبكة من جانب المُرسِل.
تصف هذه الصفحة ما تفعله كل قناة اليوم، حتى تعرف أين يمكن الوصول إلى أطرافك المقابلة قبل أن تعتمد على مسار بعينه.
الحالة في لمحة
تعني كلمة “يعمل” أن Didit ترسل التبادل وتقرأ الرد. وتعني عبارة “مطبّق، ولم يُثبت تشغيله على الشبكة الحية بعد” أن Didit ترسل التبادل وتقرأ رد الشبكة، لكن لم تكتمل أي عملية تبادل عبر تلك الشبكة مع شبكة حية بعد. ولا تعني أيٌّ من الكلمتين أن طرفًا مقابلًا بعينه يمكن الوصول إليه، فذلك يتوقف على الطرف المقابل نفسه. ويُبيّن حقل
routes في إدخال كل VASP في الدليل المسارات التي يمكن لتطبيقك استخدامها معه اليوم.
لا يحمل EMAIL إلا طلباتك الصادرة: صفحة الرد هي المكان الذي يجيب فيه الطرف المقابل عن أحدها، ولا يستطيع أي VASP أن يرسل إليك تحويلًا عبر البريد الإلكتروني.
قبل أن تعتمد على GTR أو VerifyVASP أو Sygna Bridge أو TRUST، اربط عضويتك وأجرِ أول تبادل مع طرف مقابل تعرفه.
المسارات التي لا تتطلب عضوية
INTERNAL
يعمل كلا VASP على Didit، لذلك يُسوّى التبادل داخل المنصة دون أي استدعاء خارجي. يجب أن يكون المستلم عميل Didit نشطًا مع تفعيل Travel Rule لديه، وأن يكون قد أثبت سيطرته على المحفظة المستهدفة بتوقيع رسالة أو بإيداع تجريبي. المحفظة المُعلَن عنها ذاتيًا، أو المعتمدة على لقطة شاشة فقط، أو غير الموثّقة لا تستلم أي شيء. راجع إرسال تحويل.TRP
تتعامل Didit مع بروتوكول Travel Rule مباشرة. يُرسل التحويل عبرTRP عندما يحمل Travel Address الخاص بالطرف المقابل، أو عندما يحفظ دفتر عناوين المحفظة المستهدفة عنوانًا من هذا النوع، أو عندما يُحلّ الطرف المقابل في الدليل مع endpoint TRP تحقّق الدليل منه.
كل تبادل TRP لا يكتمل في استدعاء واحد يحتاج إلى مضيف TRP العام لدى Didit، وهو المضيف الذي تشير إليه Travel Addresses:
- الإرسال. الطرف المقابل الذي يجيب عن استفسارك فورًا، في ردّه، يُكمل التحويل أو يرفضه. أما الطرف الذي يجيب لاحقًا فينشر ردّه على مضيف TRP لدى Didit، لذا لا يمكن أن يكتمل ذلك التبادل قبل أن يصبح المضيف فعّالًا، وينتظر التحويل وتنتهي صلاحيته عند الموعد النهائي. ترسل Didit الاستفسار مرة واحدة ولا تعيد إرساله: عندما لا يمكن الوصول إلى مضيف TRP لدى الطرف المقابل أو يرفض الاستفسار، يتحول التحويل فورًا إلى
COUNTERPARTY_VASP_NOT_REACHABLE، ويمكنك إعادة المحاولة باستخدامaction: "resend". - الاستقبال. تصل إليك VASPs الأخرى عبر Travel Address الخاص بك على هذا المضيف، لذلك لا يستطيع أي طرف مقابل إرسال استفسار TRP إليك قبل أن يصبح المضيف فعّالًا.
مسارات الشبكة
مع عضويتك الخاصة
اربط عضويتك الخاصة من Marketplace في لوحة التحكم (فئة شبكات Travel Rule). عندها تُرسل تحويلاتك بهويتك الخاصة على الشبكة، ولعضويتك المرتبطة الأولوية دائماً على عضوية Didit.
تدعم GTR وTRUST وVerifyVASP أيضاً شهادة عميل TLS متبادل اختيارية، ومفتاح العميل، وحزمة CA (بصيغة PEM)، وذلك لعضوية تستخدم TLS المتبادل أو سلطة شهادات خاصة.
- يرسل Didit في الخلفية، ويعيد المحاولة مع أي شبكة لا تستجيب، أو تستجيب بفشل مؤقت (لا توجد استجابة في الوقت المحدد، أو فشل في الاتصال، أو رمز HTTP
408أو429أو5xx): بعد 30 ثانية، ثم بعد دقيقتين، ثم بعد 10 و30 و60 دقيقة. وبعد المحاولة الفاشلة السادسة تصبح حالة التحويلCOUNTERPARTY_VASP_NOT_REACHABLE. أما الرفض، مثل رد آخر من فئة4xxأو إعادة توجيه، فلا تُعاد محاولته، وتصبح حالة التحويلCOUNTERPARTY_VASP_NOT_REACHABLEفوراً. - يبقى التحويل الذي لا تصل إجابته في الحالة
AWAITING_COUNTERPARTYحتى تمرconfirmation_timeout_hours، ثم ينتهي ويُطبَّقtimeout_outcomeالخاص بك. - استقبال تحويل يرسله إليك VASP آخر عبر GTR أو VerifyVASP أو Sygna Bridge غير مفعّل بعد: يفعّله Didit لكل شبكة على حدة، وحتى ذلك الحين لا تستطيع هذه الشبكات تسليم أي تحويل إليك.
- يُرجع حفظ العضوية الرمز
400إذا كان رمز المشارك هو رمز Didit الخاص على تلك الشبكة، أو رمزاً يحمله تطبيق آخر. - تحمل طلبات الشبكة بيانات اعتمادك إلى مضيف تلك الشبكة فقط، ولا تتبع أبداً أي إعادة توجيه. وتُرسل حزمة بيانات TRUST إلى المستفيد دون مفتاح API الخاص بك أو معرّف العضو أو شهادة العميل.
عبر عضوية Didit
بمجرد أن تمتلك Didit عضوية في شبكة ما، يستطيع العميل الذي لا يملك عضوية أن يصل إلى الشبكة بوصفه مشاركاً مستقلاً ضمن عضوية Didit، برمز المشارك الذي تمنحه إياه الشبكة. تُرسل الرسائل الصادرة باسم رمزك أنت، لا باسم رمز Didit. هذا الخيار متاح لـ GTR وSygna Bridge فقط. يقبل TRUST عضوية VASP واحدة في كل مرة، ويخدم VerifyVASP Enclave VASP واحداً، لذلك لا يمكن الوصول إلى هاتين الشبكتين إلا بعضويتك الخاصة. يتطلب الانضمام ثلاث خطوات: الإجابة عن استبيان الفحص النافي للجهالة للشبكة الذي يقدّمه Didit، وموافقة Didit على الاستبيان، ثم طلب الشبكة. يسجّلك Didit لدى الشبكة، ويصبح مشاركك نشطاً بمجرد أن تمنحه الشبكة رمزاً. هذا المسار غير متاح بعد. وإلى أن يُتاح، يُرجع حفظ الاستبيان أو إرساله، وكذلك طلب الشبكة، الرمز403 مع code: travel_rule_platform_networks_disabled، ويُرجع GET /v3/travel-rule/networks/ القيمة platform_networks_enabled: false.
قراءة حالة تطبيقك
تُعيدGET /v3/travel-rule/settings/ وGET /v3/travel-rule/networks/ الحقل networks، وتُفهرسه بالمفاتيح gtr وtrust وverifyvasp وsygna. يصف كل إدخال ما تستطيع الشبكة أن تفعله لتطبيقك اليوم:
يلخّص
mode الحالة في القيم own أو didit أو off أو unavailable. تُفحص عضويتك الخاصة أولاً، ثم disabled_networks، ثم عضوية Didit. وتقرأ الشبكة اليوم own_membership بمجرد ربط عضويتك الخاصة. وخلاف ذلك، تقرأ GTR وSygna Bridge didit_onboarding (وتقرأ unavailable مع sandbox_application في تطبيق تجريبي)، وتقرأ TRUST وVerifyVASP unavailable مع own_membership_only، وهذا ينطبق أيضاً في البيئة التجريبية.
لا يُرسل التطبيق التجريبي عبر أي شبكة أبداً، حتى مع ربط عضويتك الخاصة وقراءة own_membership: تُوجَّه تحويلاته إلى Didit Test VASP.
تعني connected أن عضويتك المحفوظة اجتازت التحقق المحلي، ولا تعني أن التبادل نجح. يثبت ذلك أول تبادل في بيئة الإنتاج مع الشبكة.
ما الذي يتغير عندما تدخل شبكة حيّز التشغيل
تتغير هذه الصفحة وحالةnetworks وكل مسارات الدليل معاً. لا يتغير شيء في تكاملك: يبدأ التحويل بالتوجيه عبر الشبكة بمجرد أن تكون لدى تطبيقك عضوية عليها، وفق ترتيب المسارات الموضح في كيف توجّه Didit التبادل.
لطلب شبكة لا تصل إليها Didit بعد، استخدم بطاقة Request access في Marketplace. يُظهر كل طلب حالته (Open أو Contacted أو In progress أو Live أو Declined) مع آخر ملاحظة من Didit. عندما تغيّر Didit الحالة أو الملاحظة، ترسل بريداً إلكترونياً إلى زميل الفريق الذي قدّم الطلب، ما دام لا يزال في مؤسستك. لا يتلقى الطلب المقدَّم بمفتاح API أي بريد إلكتروني، لذا تابعه في Marketplace.
الخطوات التالية
Travel Rule
دورة حياة التبادل والإعدادات والمسارات وواجهة برمجة التطبيقات /v3/.
الاختبار في البيئة التجريبية
اختبر كل نتيجة ممكنة مقابل Didit Test VASP قبل أن تفعّل التطبيق في بيئة الإنتاج.
قابلية التشغيل البيني
الـ endpoints التي تستخدمها VASPs الطرف المقابل للوصول إليك.
الدليل
ابحث عن VASP والمسارات التي يمكن لتطبيقك استخدامها معه.