البداية السريعة

من الصفر إلى
الإطلاق في 24 ساعة.

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

اختر مسارك

🛍️بدون كود

أنا تاجر

أستخدم سلة أو زد أو Shopify أو WooCommerce. لا حاجة لكود.

~15 دقيقة
API

أنا مطور

أبني تكاملاً مخصصاً باستخدام Zyrix REST API.

~ساعتان

البداية السريعة للتاجر — إعداد الإضافة

01

إنشاء حساب زيريكس

اذهب إلى zyrix.co وانقر على 'ابدأ مجاناً'. أدخل تفاصيل عملك وأنشئ حساب التاجر الخاص بك. يستغرق أقل من دقيقتين.

ستحتاج إلى: بريد إلكتروني للأعمال، رقم الهاتف، دولة التشغيل

02

إتمام التحقق من KYB

حمّل سجلك التجاري ووثيقة الضريبة وهوية المفوّض بالتوقيع. يراجع فريقنا الطلبات خلال 24 ساعة وستتلقى بريداً إلكترونياً للتأكيد.

السعودية: السجل التجاري + IBAN · تركيا: الوثيقة الضريبية + IBAN · الإمارات: الرخصة التجارية + IBAN

03

تثبيت الإضافة

من لوحة تحكم زيريكس، انتقل إلى التكاملات واختر منصتك. لسلة وزد، استخدم الإضافة الأصلية. لـ Shopify وWooCommerce، ثبّت من متجر التطبيقات الخاص بكل منصة.

سلة: التطبيقات → زيريكس · زد: التكاملات → زيريكس · Shopify: التطبيقات → بحث 'Zyrix' · WooCommerce: الإضافات → أضف جديد → Zyrix

04

إعداد الإعدادات

أدخل مفاتيح API لزيريكس (الموجودة في لوحة التحكم → مفاتيح API). اختر عملة التسوية (SAR أو AED أو TRY أو IQD أو USD). فعّل طرق الدفع التي تريد قبولها: فيات أو USDT أو BTC و/أو COD.

ابدأ بوضع الاختبار — انتقل إلى الوضع المباشر فقط بعد إتمام معاملة اختبارية

05

إجراء معاملة اختبارية

ضع طلباً اختبارياً على متجرك باستخدام رقم البطاقة الاختبارية 4111 1111 1111 1111. تحقق من ظهور الدفع في لوحة تحكم زيريكس. تأكد من إطلاق الـ webhooks بشكل صحيح.

إذا نجحت المعاملة الاختبارية، أنت جاهز للإطلاق

06

الإطلاق

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

متوسط الوقت من إنشاء الحساب حتى أول دفعة مباشرة: 18 ساعة

البداية السريعة للمطور — تكامل API

01

احصل على مفاتيح API

بعد الموافقة على حسابك، انتقل إلى لوحة التحكم → مفاتيح API. انسخ مفتاحك السري (sk_live_...) ومفتاح النشر (pk_live_...). احفظ مفتاحك السري بأمان — لا تعرضه أبداً من جانب العميل.

// احفظ في متغيرات البيئة
ZYRIX_SECRET_KEY=sk_live_xxxxxxxxxxxxxxxxxxxx
ZYRIX_PUBLISHABLE_KEY=pk_live_xxxxxxxxxxxxxxxxxxxx
02

تثبيت SDK

ثبّت SDK الرسمي لزيريكس للغتك. متاح حالياً لـ Node.js وPython وPHP.

# Node.js
npm install @zyrix/node

# Python
pip install zyrix-python

# PHP
composer require zyrix/zyrix-php
03

إنشاء نية دفع

هيّئ SDK وأنشئ أول نية دفع. تتضمن الاستجابة checkout_url لتحويل عميلك إليها.

const zyrix = require('@zyrix/node')(process.env.ZYRIX_SECRET_KEY);

const payment = await zyrix.payments.create({
  amount: 15000,          // المبلغ بأصغر وحدة (مثلاً 150.00 ريال)
  currency: 'SAR',        // SAR أو AED أو TRY أو IQD أو EGP أو USD
  method: 'auto',         // auto أو card أو usdt أو btc أو cod
  customer: {
    name: 'أحمد الرشيد',
    email: 'ahmed@example.com',
    phone: '+966501234567',
  },
  redirect_url: 'https://متجرك.com/طلب/تم-التأكيد',
  webhook_url: 'https://متجرك.com/webhooks/zyrix',
  metadata: { order_id: 'ORD-1234' },
});

// إعادة توجيه العميل
res.redirect(payment.checkout_url);
04

معالجة Webhooks

أعد نقطة نهاية webhook لاستقبال أحداث الدفع الفورية. تحقق من التوقيع باستخدام سر webhook للتأكد من الأصالة.

app.post('/webhooks/zyrix', express.raw({ type: 'application/json' }), (req, res) => {
  const signature = req.headers['x-zyrix-signature'];
  
  let event;
  try {
    event = zyrix.webhooks.constructEvent(
      req.body, signature, process.env.ZYRIX_WEBHOOK_SECRET
    );
  } catch (err) {
    return res.status(400).send('فشل التحقق من توقيع Webhook');
  }

  switch (event.type) {
    case 'payment.completed':
      await fulfillOrder(event.data.metadata.order_id);
      break;
    case 'payment.failed':
      await notifyCustomer(event.data.customer.email);
      break;
    case 'cod.confirmed':
      await markOrderDelivered(event.data.metadata.order_id);
      break;
  }

  res.json({ received: true });
});
05

الاختبار في Sandbox

انتقل إلى مفاتيح sandbox الخاصة بك وأجرِ اختبارات شاملة. استخدم البطاقة الاختبارية 4111 1111 1111 1111 للمدفوعات الناجحة.

const zyrix = require('@zyrix/node')(process.env.ZYRIX_TEST_SECRET_KEY, {
  environment: 'sandbox'
});

const testPayment = await zyrix.payments.create({
  amount: 10000,
  currency: 'SAR',
  method: 'card',
  // ... باقي المعاملات
});

console.log('رابط Sandbox:', testPayment.checkout_url);
06

الإطلاق

استبدل مفاتيح sandbox بالمفاتيح المباشرة في متغيرات بيئتك. انشر وراقب معاملاتك المباشرة الأولى من لوحة تحكم زيريكس.

// الإنتاج — استخدم المفاتيح المباشرة
const zyrix = require('@zyrix/node')(process.env.ZYRIX_SECRET_KEY);
// لا حاجة لعلامة 'environment' في الإنتاج

تحتاج مساعدة؟