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

مكتبات و SDKs

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

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

تعرف على المزيد حول وضع الاختبار مقابل الوضع المباشر.

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

1

الوصول إلى مفاتيح API

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

إنشاء مفتاح جديد

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

تخزين مفتاحك بأمان

انسخ المفتاح الذي تم إنشاؤه على الفور وتأكد من تخزينه بأمان.
4

المصادقة على طلبات API الخاصة بك

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

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

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

​
حدود المعدل

  • قياسي: 1000 طلب في الدقيقة لكل عمل
  • انفجار: حتى 100 طلب في الثانية
راقب X-RateLimit-Remaining رأس المال لتتبع الاستخدام.

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

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

أكواد الأخطاء

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

فشل المعاملات

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

​
Webhooks

استقبل إشعارات في الوقت الفعلي حول أحداث الدفع. راجع دليل Webhook للحصول على تعليمات الإعداد.

دليل Webhook

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