→ المنتجات
REST API والـ SDK

ابنِ أي شيء.
أطلق بسرعة.

REST API حديثة موثقة بالكامل مبنية للمطورين الذين يحتاجون تحكماً كاملاً. مواصفات OpenAPI 3.0 وبيئة sandbox وwebhooks وSDKs لـ Node.js وPython وPHP.

99.9%
ضمان التشغيل
3
SDKs رسمية
OpenAPI
موثق 3.0
Sandbox
بيئة اختبار

نقاط النهاية الأساسية

POST/v1/paymentsإنشاء دفعة جديدة — بطاقة أو كريبتو أو COD. يُعيد payment_id وURL الدفع.
GET/v1/payments/:idاسترجاع تفاصيل الدفعة الكاملة — الحالة والمبلغ والعملة والطريقة والطوابع الزمنية.
POST/v1/refundsإصدار استرداد كامل أو جزئي لأي دفعة مُسوَّاة.
GET/v1/settlementsقائمة بجميع سجلات التسوية — التواريخ والمبالغ والرسوم والمدفوعات الصافية لكل عملة.
POST/v1/webhooksتسجيل نقطة نهاية webhook لاستقبال أحداث الدفع الفورية.
GET/v1/balanceالحصول على رصيدك الحالي كتاجر لكل عملة في الوقت الفعلي.

SDKs الرسمية

🟩Node.jsnpm install zyrix-sdk
const zyrix = require('zyrix-sdk');
const payment = await zyrix.payments.create({
  amount: 25000,
  currency: 'IQD',
  method: 'card'
});
🐍Pythonpip install zyrix
import zyrix
client = zyrix.Client(api_key)
payment = client.payments.create(
  amount=250,
  currency='SAR',
  method='crypto'
)
🐘PHPcomposer require zyrix/sdk
$zyrix = new Zyrix\Client($apiKey);
$payment = $zyrix->payments->create([
  'amount' => 1500,
  'currency' => 'TRY',
  'method' => 'card'
]);

أحداث Webhook

payment.completed

يُطلق عند تأكيد الدفعة بالكامل والتقاط الأموال.

payment.failed

يُطلق عند فشل محاولة دفع — يتضمن رمز الخطأ والسبب.

payment.pending

يُطلق للمدفوعات الكريبتو في انتظار تأكيد البلوكشين.

refund.issued

يُطلق عند معالجة الاسترداد بنجاح.

dispute.opened

يُطلق عند رفع chargeback أو نزاع من بنك العميل.

settlement.completed

يُطلق عند معالجة دفعة تسوية وإرسال الأموال.

تجربة المطور

📖

مواصفات OpenAPI 3.0

مواصفات API قابلة للقراءة آلياً. استورد لـ Postman أو Insomnia أو أي عميل API. توليد كود عميل تلقائي بأكثر من 40 لغة.

🧪

بيئة Sandbox

بيئة اختبار كاملة مع محاكاة تدفقات الدفع وتسليم webhooks ودورات التسوية. بطاقات اختبار ومحافظ كريبتو اختبار وCOD اختبار.

🔑

إدارة مفاتيح API

أنشئ مفاتيح API منفصلة للإنتاج والاختبار. قيّد المفاتيح بالـ IP أو الدومين أو نطاق الصلاحية. دوّر المفاتيح بدون توقف.

📊

سجلات الطلبات

سجلات طلب واستجابة كاملة لكل استدعاء API — قابلة للتصفية حسب نقطة النهاية والحالة والوقت. حل مشاكل التكامل بدون تخمين.

زمن استجابة منخفض

أوقات استجابة API أقل من 200ms لمعظم نقاط النهاية. مستضاف على بنية تحتية حافة عبر الشرق الأوسط وأوروبا.

🔒

توقيع Webhook بـ HMAC

كل webhook موقّع بـ HMAC-SHA256. تحقق من التوقيعات على خادمك لضمان أن الأحداث من Zyrix حقاً.

ابدأ البناء

احصل على مفاتيح API sandbox وابدأ التكامل في دقائق.