The Complete Zyrix Reference

What is Zyrix?

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

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

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

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

Create Account وLogin

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

🔑 Login — الخطوات التفصيلية

🚀 Onboarding — إعداد حسابك كاملاً

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

اقبل First Payment لك

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

Dashboard

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

📈 فهم KPIs الأربعة

📉 Chart للحجم

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

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

⚡ Quick Actions

Transactions

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

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

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

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

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

🏷️ Transaction States — دليل كامل

🔍 Transaction Detail الكاملة

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

📤 تصدير Transactions

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

Balance & Settlements

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

💰 شاشة Balance

شاشة Balance تعرض ثلاثة أرقام مهمة:

🏦 جدول Settlements

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

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

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

💸 Money Transfer (FAST / EFT)

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

Payment Links

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

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

تتبع Payment Links

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

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

نظام Invoices

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

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

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

Analytics المتقدمة

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

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

🎯 Revenue Goals

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

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

💼 Expense Tracking

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

Disputes والاعتراضات

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

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

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

Fraud Monitor

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

درجة Security (Security Score)

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

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

Blacklist الذكية

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

ما يمكنك حظره

Settings وProfile

تخصيص حسابك، إدارة Security، وإعداد تفضيلات Notifications.

Profile

من Settings ← Profile يمكنك تحديث:

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

🔒 إعدادات Security

🔔 إعدادات Notifications

⚙️ API Keys

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

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

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

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

Authentication (Authentication)

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

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

💳 API Transactions

// مثال — جلب آخر 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 Payments

// الطلب
{
  "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

🚨 Error Codes الكاملة

Troubleshooting وحلها

حلول موثّقة لكل مشكلة محتملة — من أبسط Login Issues لأعقد API Errors.

🔑 مشاكل Login

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

🏦 مشاكل Settlements

⚡ استكشاف API Errors

# 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

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

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

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

Compliance & Licenses وSecurity

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

قنوات Technical Support

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