انتقل إلى المحتوى
WATADCASH API v2

المصادقة والصلاحيات

احفظ المفتاح على الخادم، وحدد له الصلاحيات اللازمة للخدمة التي تربطها.

Bearer authentication

أرفق المفتاح في ترويسة Authorization. تفحص الخدمة صلاحياته، وحالة الباقة، وملكية المورد في كل طلب.

HTTP
Authorization: Bearer YOUR_SERVER_KEY
Content-Type: application/json

الصلاحيات

الصلاحيةاستخدامها
wallet:readرصيد محفظة التاجر، فواتير تمويل محفظة التاجر
transactions:readحركات المحفظة، التحويلات، تفاصيل التحويلات، الحوالات المكتبية، تفاصيل الحوالات المكتبية
customers:readالعملاء، تفاصيل العملاء
customers:writeإنشاء عميل
cards:readالبطاقات، تفاصيل البطاقات، طلبات البطاقات، تفاصيل طلبات البطاقات، منتجات البطاقات المتاحة
cards:createطلب إصدار بطاقة
invoices:readفواتير USDT للعملاء، تفاصيل فواتير USDT للعملاء
invoices:createفتح فاتورة USDT لعميل
wallet_payments:readطلبات الدفع من محفظة WATADCASH، تفاصيل طلبات الدفع من محفظة WATADCASH
wallet_payments:createطلب دفع من محفظة WATADCASH
withdrawals:readالسحوبات، تفاصيل السحوبات
withdrawals:createتأكيد طلب السحب، عرض سحب USDT عبر TRON
transfers:createتحويل إلى حساب WATADCASH
office:transfers:createحوالة إلى مكتب
wallet:fundفاتورة USDT لتمويل محفظة التاجر
cards:fundطلب تمويل بطاقة مملوكة

المبالغ والمعرفات

أرسل المبالغ كنصوص عشرية لتجنب أخطاء الأعداد العائمة. تمويل البطاقات يستخدم USD، بينما فواتير USDT تستخدم الشبكة والعملة المحددتين في الخدمة.

معرف المورد في المسار عدد صحيح صادر عن الخادم. في السحب، استخدم resource_id الرقمي للمسار /withdrawals/{id}، ولا تستخدم مرجع GW النصي مكانه.

إعادة الطلب بأمان

استخدم Idempotency-Key للعمليات التي تتطلبه في المرجع. أعد استخدام المفتاح نفسه للطلب المنطقي نفسه، ولا تغيّر بياناته عند إعادة المحاولة.

لا تضف معاملات استعلام إلى مسارات API الموثقة. أرسل حقول الإنشاء في جسم JSON.

مرجع API الكاملتحديث الوثائق: 9 أكتوبر 2026