المطورون
ابنِ مدفوعات لـ
الشرق الأوسط وتركيا.
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/nodePythonوصول مبكر
pip install zyrix-pythonPHPوصول مبكر
composer require zyrix/zyrix-phpRubyقريباً
gem install zyrixGoقريباً
go get github.com/zyrix/zyrix-goأحداث Webhook
payment.completedيُطلق عند معالجة دفعة بنجاح
payment.failedيُطلق عند فشل محاولة دفع
cod.confirmedيُطلق عند تأكيد توصيل COD
cod.returnedيُطلق عند إرجاع طلب COD
settlement.processedيُطلق عند تسوية الأموال في حسابك
dispute.openedيُطلق عند بدء استرداد مبالغ