الانتقال إلى المحتوى الرئيسي
POST
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
beneficiary_wallet_address
string
مطلوب

عنوان محفظة الوجهة. يرسل Didit Test VASP إليها، وتتم مطابقتها مع دفتر عناوين المحافظ الخاص بك على شبكة الأصل المالي. تُقبل المحفظة التي ليس لها إدخال مطابق وتُسجّل المعاملة الواردة بالحالة ON_HOLD.

scenario
enum<string>
افتراضي:accept

ما يصرح به Didit Test VASP بشأن المستفيد. يصرح accept باسم الحامل نفسه؛ بينما يصرح name_mismatch باسم لا يوافق عليه أي حامل. القرار نفسه يرجع إليك دائماً.

الخيارات المتاحة:
accept,
name_mismatch
chain
string
افتراضي:ETH

شبكة البلوكتشين الخاصة بالأصل.

amount
string
افتراضي:1

المبلغ كسلسلة عشرية.

currency
string
افتراضي:ETH

رمز الأصل.

reference
string

مفتاح idempotency اختياري. يؤدي التكرار بنفس القيمة إلى إرجاع التحويل الذي سجله الاستدعاء الأول.

الاستجابة

تم تسجيل التحويل الوارد واتخاذ القرار بشأنه. يؤدي التكرار باستخدام نفس reference إلى إرجاع نفس النص الأساسي.

transaction_id
string<uuid>

معرّف UUID لمعاملة Didit للتحويل الوارد.

txn_id
string

قيمة txn_id التي أنشأتها Didit.

scenario
string

السيناريو الذي تم تشغيله.

travel_rule_status
string

الحالة التي استقر عليها القرار الخاص بتطبيقك.

detail
string

سبب استقرار التحويل على تلك الحالة.

test_vasp
boolean

دائماً true: كان المُرسِل هو Didit Test VASP.

travel_rule
object

كائن التحويل الكامل الذي يتم إرجاعه بواسطة endpoints الخاصة بتأكيد الملكية والإنهاء/الإلغاء. طالما أن ملكية المحفظة لتحويل وارد غير مؤكدة، يتم إرجاع originator_data وbeneficiary_data للطرف المقابل محجوبة (يتم الاحتفاظ بالحرف الأول من كل كلمة؛ بينما تظل المحفظة، والبلوكتشين، وتوجيه VASP قابلة للقراءة) وتكون قيمة data_masked هي true.

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