مقدمة/معلومات عامة
معلومات عامة
المواصفات التقنية لمعالجة مدفوعات العملات المشفرة وتكامل عمليات السحب مع 2328.io.
مرحبًا بكم في توثيق واجهة برمجة تطبيقات 2328.io. يصف هذا المرجع كيفية دمج معالجة مدفوعات العملات المشفرة وعمليات السحب في تطبيقك.
البدء
لبدء عملية الدمج:
- أنشئ حساب تاجر ومشروعًا في 2328.io
- احصل على project UUID وAPI key من إعدادات المشروع
- أنشئ Payout API key منفصلًا إذا كنت تخطط لاستخدام عمليات السحب
- اقرأ قسم Authentication للتعرف على كيفية توقيع الطلبات
- قم بأول استدعاء Create Payment
عنوان URL الأساسي
تستخدم جميع طلبات API في بيئة الإنتاج عنوان URL الأساسي التالي:
Text
https://api.2328.io/apiيجب إجراء جميع الطلبات عبر HTTPS. الطلبات التي لا تستخدم HTTPS يتم حظرها.
ما يمكنك القيام به
من خلال واجهة 2328.io API يمكنك:
- قبول مدفوعات العملات المشفرة — إنشاء جلسات دفع وإعادة توجيه العملاء إلى صفحة دفع مستضافة أو Telegram MiniApp
- سحب الأموال — إرسال عمليات سحب برمجيًا من رصيد التاجر إلى أي عنوان بلوكتشين
- التحقق من الأرصدة — تحقق من أرصدة حسابات التاجر لكل عملة وما يعادلها بالدولار والمبالغ المحجوزة بسبب AML
- استخدام المحافظ الثابتة — إنشاء عناوين إيداع دائمة مرتبطة بمستخدم أو طلب
- جلب أسعار الصرف — الحصول على أسعار فورية لأزواج العملات الورقية والمشفرة
- استقبال webhooks — تلقي إشعار فوري عند تغير حالة الدفع
حدود معدل الطلبات
تسمح واجهة API بحد أقصى 10 طلبات في الثانية لكل مشروع. الطلبات التي تتجاوز هذا الحد تتلقى استجابة HTTP 429 Too Many Requests — انتظر قليلًا ثم أعد المحاولة.