المرجع الشامل لـ زايركس

ما هو زايركس؟

زايركس هو بوابة الدفع المحلية المصممة خصيصاً لتجار الشرق الأوسط وتركيا — من أول معاملة حتى ملايين الليرات شهرياً.

على عكس البوابات العالمية كـ Stripe وPayPal التي تُجبرك على التعامل بالدولار وتدفع ضرائب تحويل مرتفعة، بُني زايركس من الصفر بثلاث مبادئ محورية:

🗺️ الأسواق المدعومة

⚡ ما الذي يميز زايركس عن المنافسين؟

إنشاء الحساب وتسجيل الدخول

من الصفر إلى قبول أول دفعة في أقل من 10 دقائق. لا وثائق مطلوبة للبداية.

🔑 تسجيل الدخول — الخطوات التفصيلية

🚀 معالج الترحيب — إعداد حسابك كاملاً

بعد تسجيل الدخول للمرة الأولى، سيظهر معالج ترحيب اختياري من 3 خطوات. يمكنك تخطيه الآن والعودة لاحقاً من الإعدادات ← الملف الشخصي.

اقبل أول دفعة لك

أسرع طريقة لقبول مدفوعات دون موقع أو برمجة: رابط الدفع القابل للمشاركة.

لوحة التحكم

مركز القيادة — كل ما يهمك عن مدفوعاتك في لمحة. الشاشة الأولى بعد تسجيل الدخول.

📈 فهم مؤشرات الأداء الأربعة

📉 الرسم البياني للحجم

أسفل مؤشرات الأداء، يعرض رسم بياني خطي حجم مدفوعاتك عبر الزمن. يمكنك التبديل بين:

• آخر 7 أيام: عرض يومي — مفيد لمتابعة الأداء الأسبوعي
• آخر 30 يوم: عرض يومي — للنمط الشهري
• آخر 90 يوم: عرض أسبوعي — للاتجاه الربعي

⚡ الإجراءات السريعة

المعاملات

السجل الكامل لكل دفعة — ناجحة أو معلقة أو فاشلة. بحث وتصفية وتصدير بسهولة.

🔍 البحث والتصفية

شريط البحث في أعلى شاشة المعاملات يدعم البحث بـ:

• رقم المعاملة: مثلاً ZRX-00001 — نتيجة فورية
• اسم العميل: اكتب جزءاً منه — البحث تدريجي (لا حاجة لكامل الاسم)
• المبلغ: مثلاً 1200 — يعرض كل معاملات قيمتها ₺1,200
• آخر 4 أرقام من البطاقة: مثلاً 4144

أزرار التصفية

🏷️ حالات المعاملة — دليل كامل

🔍 تفاصيل المعاملة الكاملة

انقر على أي معاملة في القائمة لعرض شاشة التفاصيل الكاملة. تحتوي على:

📤 تصدير المعاملات

انقر "تصدير CSV" في شاشة المعاملات لتحميل ملف يحتوي:

الرصيد والتسويات

فهم كيف تتدفق أموالك من لحظة الدفع حتى وصولها لحسابك البنكي.

💰 شاشة الرصيد

شاشة الرصيد تعرض ثلاثة أرقام مهمة:

🏦 جدول التسويات

زايركس يحوّل أموالك لحسابك البنكي (IBAN) وفق جدول منتظم:

ماذا يعني "تسوية T+2"؟

T = يوم المعاملة. T+2 = تُسوَّى بعد يومي عمل. مثال: معاملة الأحد تُسوَّى الثلاثاء. معاملة الخميس تُسوَّى الاثنين (بتخطي الجمعة).

💸 تحويل الأموال (FAST / EFT)

من شاشة التحويل، يمكنك إرسال أموال مباشرة لأي حساب بنكي تركي:

روابط الدفع

الأداة الأقوى والأبسط — أنشئ رابط دفع احترافي وشاركه في أي قناة خلال 30 ثانية.

خيارات إنشاء الرابط

تتبع روابط الدفع

كل رابط في قائمة "روابط الدفع" يعرض:

• الحالة: نشط / منتهي / استُخدم
• عدد المشاهدات: كم شخص فتح الرابط
• عدد الدفعات: كم شخص أتم الدفع فعلاً
• معدل التحويل: نسبة من فتح الرابط ودفع
• تاريخ الإنتهاء: متى ينتهي

نظام الفواتير

أنشئ وأرسل فواتير احترافية مع حساب ضريبة القيمة المضافة (KDV/VAT) تلقائياً.

إنشاء فاتورة جديدة

حالات الفاتورة

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

فهم أنماط مدفوعاتك وعملائك لاتخاذ قرارات أكثر ذكاءً.

الرسوم البيانية المتاحة

🎯 أهداف الإيرادات

حدد هدف إيراد شهري وتابع تقدمك في الوقت الفعلي:

• حدد هدف مثلاً "₺100,000 في مارس"
• شريط تقدم يعرض: "₺47,230 — 47.2% من الهدف"
• توقع وصول الهدف بناءً على المعدل الحالي: "ستصل للهدف في 18 مارس"
• إشعار تلقائي عند الوصول لـ 50% / 75% / 100% من الهدف

💼 تتبع المصروفات

سجّل مصروفات عملك مباشرة في زايركس للحصول على صورة كاملة عن الربحية:

النزاعات والاعتراضات

النزاعات (Chargebacks) هي الاعتراضات التي يرفعها العملاء على دفعات. فهمها والتعامل معها بسرعة يحميك من خسائر كبيرة.

أنواع النزاعات وكيفية الرد

خطوات الرد على نزاع

مراقبة الاحتيال

نظام ذكاء اصطناعي يعمل 24/7 لحمايتك من المعاملات المشبوهة والاحتيال.

درجة الأمان (Security Score)

رقم من 0 إلى 100 يعكس الوضع الأمني العام لحسابك:

أنواع التنبيهات الأمنية

القائمة السوداء الذكية

احظر عناوين IP محددة، بريدات إلكترونية، دول، أو أرقام بطاقات بضغطة واحدة.

ما يمكنك حظره

الإعدادات والملف الشخصي

تخصيص حسابك، إدارة الأمان، وإعداد تفضيلات الإشعارات.

الملف الشخصي

من الإعدادات ← الملف الشخصي يمكنك تحديث:

• اسمك الكامل: يظهر في الفواتير والإيصالات
• البريد الإلكتروني: لاستلام التقارير والتنبيهات
• اسم الشركة: يظهر في كل الوثائق الرسمية
• IBAN التسوية: الحساب البنكي لاستلام الأموال
• الشعار: يظهر في صفحات الدفع والفواتير

🔒 إعدادات الأمان

🔔 إعدادات الإشعارات

⚙️ مفاتيح API

لدمج زايركس في موقعك أو تطبيقك، تحتاج مفاتيح API:

• Publishable Key: يبدأ بـ pk_live_ — يُستخدم في الواجهة الأمامية (آمن للنشر)
• Secret Key: يبدأ بـ sk_live_ — يُستخدم في الخادم فقط. لا تنشره أبداً في الكود العام
• مفاتيح Test: تبدأ بـ pk_test_ وsk_test_ — للاختبار بدون دفع حقيقي

مرجع REST API الكامل

دمج زايركس في أي تطبيق أو موقع باستخدام REST API الشامل.

المصادقة (Authentication)

كل الطلبات تتطلب مفتاح API في Header:

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxx
Content-Type: application/json
X-Zyrix-Version: 2026-03-01

💳 API المعاملات

// مثال — جلب آخر 10 معاملات ناجحة
GET /v1/transactions?limit=10&status=success¤cy=TRY

// الاستجابة
{
  "data": [
    {
      "id": "txn_ZRX00001",
      "amount": 150000,        // بالقرش (piastres) — ₺1,500.00
      "currency": "TRY",
      "status": "success",
      "fee": 1200,             // ₺12.00 (0.8%)
      "net": 148800,           // ₺1,488.00
      "method": "card",
      "card_last4": "4144",
      "created_at": "2026-03-22T14:22:05Z"
    }
  ],
  "total": 247,
  "has_more": true
}

GET /v1/transactions/txn_ZRX00001

{
  "id": "txn_ZRX00001",
  "amount": 150000,
  "currency": "TRY",
  "status": "success",
  "fee": 1200,
  "net": 148800,
  "method": "card",
  "card": {
    "last4": "4144",
    "brand": "visa",
    "country": "TR",
    "funding": "debit"
  },
  "customer": {
    "name": "Ahmed Khalid",
    "email": "ahmed@example.com",
    "ip": "88.243.197.x"
  },
  "three_ds": {
    "authenticated": true,
    "version": "2.2"
  },
  "timeline": [
    { "event": "created",       "at": "2026-03-22T14:22:00Z" },
    { "event": "3ds_initiated",  "at": "2026-03-22T14:22:01Z" },
    { "event": "3ds_completed",  "at": "2026-03-22T14:22:03Z" },
    { "event": "captured",      "at": "2026-03-22T14:22:05Z" }
  ],
  "created_at": "2026-03-22T14:22:05Z"
}

🔗 API الدفعات

// الطلب
{
  "amount": 320000,
  "currency": "TRY",
  "description": "تصميم شعار شركة",
  "expires_in": 604800,  // 7 أيام
  "single_use": true,
  "metadata": {
    "order_id": "ORD-045",
    "customer_id": "CUST-001"
  }
}

// الاستجابة
{
  "id": "pl_abc123xyz",
  "url": "https://pay.zyrix.co/p/abc123xyz",
  "amount": 320000,
  "currency": "TRY",
  "status": "active",
  "expires_at": "2026-03-29T14:30:00Z"
}

🪝 Webhooks

Webhooks تُرسل إشعاراً فورياً لخادمك عند كل حدث مهم. أفضل بكثير من polling.

الأحداث المتاحة

مثال Webhook Payload

{
  "event": "payment.success",
  "id": "evt_xyz789",
  "created_at": "2026-03-22T14:22:05Z",
  "data": {
    "transaction_id": "txn_ZRX00001",
    "amount": 150000,
    "currency": "TRY",
    "net": 148800,
    "customer_name": "Ahmed Khalid",
    "metadata": { "order_id": "ORD-045" }
  }
}

التحقق من صحة Webhook (Signature Verification)

# Python
import hmac, hashlib

def verify_webhook(payload: bytes, signature: str, secret: str) -> bool:
    expected = hmac.new(
        secret.encode(), payload, hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(f"sha256={expected}", signature)

# في controller:
sig = request.headers.get("X-Zyrix-Signature")
if not verify_webhook(request.body, sig, WEBHOOK_SECRET):
    return 401

🚨 رموز الأخطاء الكاملة

استكشاف الأخطاء وحلها

حلول موثّقة لكل مشكلة محتملة — من أبسط مشاكل الدخول لأعقد أخطاء API.

🔑 مشاكل تسجيل الدخول

💳 مشاكل المدفوعات

🏦 مشاكل التسويات

⚡ استكشاف أخطاء API

# Python — Exponential Backoff
import time

for attempt in range(5):
    resp = requests.get(url, headers=headers)
    if resp.status_code == 429:
        wait = int(resp.headers.get("Retry-After", 60))
        time.sleep(wait)
        continue
    break

الأسعار والخطط

تسعير شفاف بلا رسوم مخفية. ابدأ مجاناً وانتقل للخطة المناسبة عند النمو.

مقارنة التكاليف الفعلية

التوافق والرخص والأمان

زايركس يعمل في إطار منظومة تنظيمية كاملة في تركيا ودول الخليج.

قنوات الدعم الفني

فريق دعم متخصص يتحدث العربية والتركية والإنجليزية.