الانتقال إلى المحتوى الرئيسي

SDKs & Libraries

سرّع تكاملك باستخدام SDKs الرسمية لـ TypeScript وPython وGo وPHP وJava وKotlin وC# وRuby وReact Native. تبسط هذه المكتبات طلبات واجهة برمجة التطبيقات والمصادقة ومعالجة الأخطاء، مما يتيح لك التركيز على إنشاء تجارب دفع مميزة.

​
عناوين البيئة

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

​
إدارة مفاتيح API والمصادقة

1

Access API Keys

انتقل إلى المطور → مفاتيح API في لوحتك لإدارة المفاتيح.
2

Generate a New Key

اختر إضافة مفتاح API، وعيّن اسمًا وصفيًا، وقم بتكوين صلاحية الكتابة:
  • تمكين الوصول للكتابة (محدد): أذونات قراءة وكتابة كاملة لجميع عمليات API
  • تمكين الوصول للكتابة (غير محدد): وصول للقراءة فقط - يمكن فقط جلب البيانات (المدفوعات، الاشتراكات، العملاء، المنتجات). لا يمكن إنشاء أو تعديل الموارد.
قم بإلغاء تحديد “تمكين صلاحية الكتابة” للتكاملات على لوحة التحكم، وأدوات التحليلات، وأي نظام يحتاج فقط لعرض البيانات دون إجراء تغييرات.
3

Store Your Key Securely

انسخ المفتاح المُنشأ فورًا وتأكد من تخزينه بأمان.
4

Authenticate Your API Requests

استخدم مفاتيح API الخاصة بك للمصادقة على جميع الطلبات. طبق تنسيق التفويض التالي:
Authorization: Bearer YOUR_API_KEY
لا تكشف أبدًا عن مفاتيح API السرية في شفرة العميل أو المستودعات العامة.

​
تنسيق الاستجابة

{
  "id": "pay_1234567890",
  "status": "completed",
  "amount": 2999,
  "currency": "USD",
  "created_at": "2024-01-15T10:30:00Z"
}

​
حدود المعدل

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

​
الحدود الافتراضية (الطبقة 0)

النافذةالحد
لكل ثانية (اندفاع)40 طلبًا
لكل دقيقة (مستدام)240 طلبًا

​
طبقات الأعمال

تتوفر حدود معدل أعلى للأعمال التي لديها احتياجات أكبر لواجهة برمجة التطبيقات:
الطبقةاندفاع (لكل ثانية)مستدام (لكل دقيقة)
الطبقة 0 (الافتراضية)40240
الطبقة 11001,000
الطبقة 25005,000
اتصل بالدعم لترقية عملك إلى طبقة حدود معدل أعلى.

​
الطلبات غير المصادق عليها

الطلبات التي لا تحتوي على رؤوس مصادقة صالحة يتم تقييدها حسب عنوان IP:
النافذةالحد
لكل ثانية (اندفاع)20 طلبًا
لكل دقيقة (مستدام)100 طلبًا

​
رؤوس حدود المعدل

راقب استخدامك باستخدام هذه الرؤوس في الاستجابة:
  • X-RateLimit-Limit - الحد الأقصى للطلبات المسموح بها
  • X-RateLimit-Remaining - الطلبات المتبقية في النافذة الحالية
  • X-RateLimit-Reset - الوقت الذي تعاد فيه تعيين حد المعدل
عندما تتجاوز حدود المعدل، تعيد واجهة برمجة التطبيقات استجابة 429 Too Many Requests. نفّذ تراجعًا أسّيًا في منطق إعادة المحاولة.

​
معالجة الأخطاء

لإدارة الأخطاء بفاعلية، راجع أقسام رموز الخطأ و_فشل المعاملات_ للحصول على إرشادات مفصلة.

Error Codes

استكشف تفاصيل الأخطاء الشاملة وحلولها.

Transaction Failures

اكتسب رؤى حول مشكلات المعاملات الشائعة وحلولها.

​
الويب هوكات

تلقَّ إشعارات فورية حول أحداث الدفع. راجع دليل الويب هوك للحصول على تعليمات الإعداد.

Webhook Guide

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

Webhook Guide

Set up webhooks for real-time notifications and event handling.