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

الشبكة التي تم تسوية الإيداع عليها، مثل ETH. يتم تخزينها بأحرف صغيرة وتتم مقارنتها بدون حساسية لحالة الأحرف مع مدخلات دفتر عناوين المحفظة لديك، لذا استخدم رمز الشبكة نفسه هناك.

Maximum string length: 32
txid
string
مطلوب

تجزئة المعاملة على السلسلة. تمت إزالة التكرار مع wallet_address.

Maximum string length: 128
wallet_address
string
مطلوب

محفظة الوجهة التي استلمت الإيداع عليها. يتم تقسيم عنوان XRP من نوع X-address إلى عنوانه الكلاسيكي ووسمه.

Maximum string length: 128
amount
string
مطلوب

مبلغ الإيداع كسلسلة عشرية، صفر أو أكثر، بما يصل إلى 18 منزلة عشرية.

currency
string
مطلوب

أصل الإيداع، مثل "USDC".

Maximum string length: 16
originator_data
object

تفاصيل المُرسِل من VASP المرسل، إن كانت معروفة، ككائن مسطح مثل {"name": "..."}. يقرأ Didit الاسم (أو full_name) وfirst_name وlast_name وvendor_data منه.

beneficiary_data
object

تفاصيل المستفيد (عميلك)، ككائن مسطح مثل {"name": "..."}. تطابق Didit الاسم مع holder_name لمدخل دفتر العناوين المطابق، وتُحدد wallet_address وchain من الطلب.

originating_vasp
object

وصف اختياري لـ VASP المُرسِل. يقتصر على هذه المعاملة فقط (metadata.originating_vasp، وVASP المُرسِل للمعاملة في GET /v3/travel-rule/transfers/)؛ ولا يُنشئ أبداً إدخالاً مشتركاً في دليل VASP أو يعدله أو يربطه.

memo
string

اختياري. علامة الوجهة (destination tag) للإيداع أو المذكرة (memo) على شبكة تستخدم المذكرات: في عنوان الإيداع المشترك، هي ما يميّز عملاءك عن بعضهم، وتتم مطابقة مدخل دفتر العناوين الخاص بتلك المذكرة. XRP: علامة وجهة، وهي رقم صحيح من 0 إلى 4294967295 (يُقبل رقم بتنسيق JSON). XLM: مذكرة نصية تصل إلى 28 بايتاً، أو معرّف 64 بت أو تجزئة 32 بايت بصيغة hex. EOS: حتى 256 بايتاً. ATOM: حتى 256 حرفاً. HBAR: حتى 100 بايت. محافظ Bitcoin و EVM و Solana و Tron و Litecoin و Bitcoin Cash و Dogecoin و Lightning لا تقبل أي مذكرة: يؤدي وضع مذكرة هناك إلى إرجاع 400. الاسم البديل: destinationTag أو destination_tag.

Maximum string length: 256
utxo
object

اختياري، لسلاسل UTXO فقط. مدخلات معاملة الإيداع ومخرجاتها: محفظة المرسل هي originator_data.wallet_address المحددة، وإلا فأكبر مدخل.

الاستجابة

تم تسجيل تحويل مسبقاً لـ txid و wallet_address هذين؛ يتم إرجاع التحويل الحالي دون تغيير (created بقيمة false).

transaction_id
string<uuid>

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

txn_id
string

txn_id للمعاملة الواردة: منشأ بواسطة Didit عندما أنشأت Didit المعاملة، أو المعرّف الخاص بك عند إعادة استخدام إيداع لم تتم المطالبة به.

created
boolean

true عندما يسجل هذا الاستدعاء التحويل (HTTP 201)؛ وfalse عند وجود تحويل مسبق لنفس txid وwallet_address بالفعل (HTTP 200).

travel_rule
object

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

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