المطورون

ابنِ مدفوعات لـ
الشرق الأوسط وتركيا.

REST API حديثة مصممة للمطورين الذين يريدون دمج المدفوعات بسرعة — مع توثيق كامل وبيئة sandbox ومكتبات SDK بلغات متعددة.

🚧 بوابة المطورين لدينا في الوصول المبكر حاليًا. ستكون الوثائق الكاملة متاحة على docs.zyrix.co. تواصل معنا لطلب وصول sandbox.
📡

REST API

مواصفات OpenAPI 3.0. طلبات/استجابات JSON. عناوين URL موجهة بالموارد.

🧪

بيئة Sandbox

اختبر تكاملك بدون أموال حقيقية. محاكاة كاملة للمدفوعات وCOD والـ webhooks.

🔔

Webhooks

إشعارات أحداث فورية للمدفوعات والتسويات وتحديثات COD والنزاعات.

📦

SDKs

مكتبات رسمية لـ Node.js وPython وPHP وRuby. مكتبات مجتمعية لـ Go وJava.

🔐

مفاتيح API والتوثيق

توقيع الطلبات HMAC-SHA256. مفاتيح منفصلة لبيئات الإنتاج والاختبار.

📊

الـ Idempotency

إعادة محاولات آمنة بمفاتيح idempotency. لا تفرض رسومًا مضاعفة أبدًا.

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

// تثبيت Zyrix SDK
npm install @zyrix/node

// إنشاء دفع
const zyrix = require('@zyrix/node')('YOUR_API_KEY');

const payment = await zyrix.payments.create({
  amount: 10000,        // المبلغ بأصغر وحدة عملة
  currency: 'SAR',     // SAR, AED, TRY, IQD, EGP...
  method: 'usdt',      // usdt, btc, cod, card
  customer: {
    name: 'أحمد الرشيد',
    email: 'ahmed@example.com',
    phone: '+966501234567'
  },
  metadata: {
    order_id: 'ORD-9821'
  }
});

console.log(payment.checkout_url);
// → https://pay.zyrix.co/checkout/ch_xxxxx

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

POST/v1/payments
GET/v1/payments/:id
POST/v1/payments/:id/refund
POST/v1/cod/orders
PUT/v1/cod/orders/:id
GET/v1/settlements
POST/v1/webhooks
GET/v1/balance

SDKs المتاحة

Node.jsوصول مبكر
npm install @zyrix/node
Pythonوصول مبكر
pip install zyrix-python
PHPوصول مبكر
composer require zyrix/zyrix-php
Rubyقريباً
gem install zyrix
Goقريباً
go get github.com/zyrix/zyrix-go

أحداث Webhook

payment.completed

يُطلق عند معالجة دفعة بنجاح

payment.failed

يُطلق عند فشل محاولة دفع

cod.confirmed

يُطلق عند تأكيد توصيل COD

cod.returned

يُطلق عند إرجاع طلب COD

settlement.processed

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

dispute.opened

يُطلق عند بدء استرداد مبالغ

مستعد للبناء؟

اطلب وصول sandbox وابدأ دمج Zyrix في منصتك اليوم.