SDKs & Libraries
حزم SDK رسمية للواجهة الخلفية للغات TypeScript وPython وGo وPHP وJava وKotlin وC# وRuby وRust. تعمل هذه المكتبات على تبسيط طلبات API والمصادقة ومعالجة الأخطاء، ما يتيح لك التركيز على بناء تجارب دفع متميزة.
Mobile Checkout SDKs
هل تبني تطبيقًا أصليًا؟ افتح صفحة الدفع المستضافة من Dodo واستلم نتيجة مكتوبة الأنواع في استدعاء واحد، على Android وiOS وReact Native وFlutter. لا تحتوي هذه الخيارات على API key.
عناوين URL للبيئات
- وضع الاختبار:
https://test.dodopayments.com - الوضع المباشر:
https://live.dodopayments.com
تعرّف على المزيد حول وضع الاختبار مقابل الوضع المباشر.
إدارة API Key والمصادقة
1
Access API Keys
انتقل إلى Developer → API Keys في لوحة التحكم لإدارة مفاتيحك.
2
Generate a New Key
حدّد Add API Key، وأدخل اسمًا وصفيًا، واضبط صلاحية الكتابة:
- Enable write access (محددة): أذونات كاملة للقراءة والكتابة لجميع عمليات API
- Enable write access (غير محددة): صلاحية للقراءة فقط - يمكنها جلب البيانات فقط (المدفوعات والاشتراكات والعملاء والمنتجات). لا يمكنها إنشاء الموارد أو تعديلها.
3
Store Your Key Securely
انسخ المفتاح الذي تم إنشاؤه فورًا واحرص على تخزينه بأمان.
4
Authenticate Your API Requests
استخدم مفاتيح API للمصادقة على جميع الطلبات. طبّق تنسيق التفويض التالي:
تنسيق الاستجابة
حدود المعدل
تستخدم API لدينا نظامًا مزدوج النوافذ للحد من المعدل مع حماية من الاندفاعات. تُطبّق الحدود استنادًا إلى طريقة المصادقة ودرجة نشاطك التجاري.الحدود الافتراضية (Tier 0)
درجات النشاط التجاري
تتوفر حدود معدل أعلى للأنشطة التجارية ذات احتياجات API المتزايدة:الطلبات غير المصادق عليها
تُحدَّد الطلبات التي لا تحتوي على ترويسات مصادقة صالحة استنادًا إلى عنوان IP:ترويسات حدود المعدل
راقب استخدامك من خلال ترويسات الاستجابة التالية:X-RateLimit-Limit- الحد الأقصى للطلبات المسموح بهاX-RateLimit-Remaining- الطلبات المتبقية في النافذة الحاليةX-RateLimit-Reset- وقت إعادة ضبط حد المعدل
عند تجاوز حدود المعدل، تُرجع API استجابة
429 Too Many Requests. طبّق التراجع الأُسّي في منطق إعادة المحاولة لديك.معالجة الأخطاء
لإدارة الأخطاء بفعالية، راجع قسمي رموز الأخطاء و_فشل المعاملات_ للحصول على إرشادات مفصلة.Error Codes
تعمّق في تفاصيل الأخطاء الشاملة وحلولها.
Transaction Failures
اطّلع على المشكلات الشائعة في المعاملات وحلولها.
Webhooks
استلم إشعارات فورية حول أحداث الدفع. راجع دليل Webhook للحصول على تعليمات الإعداد.Webhook Guide
أعدّ Webhooks للإشعارات الفورية ومعالجة الأحداث.
أدلة المطور ذات الصلة
استكشف أدلتنا الشاملة لفهم كيفية تنفيذ الميزات الأساسية باستخدام API:One-time Payments Integration
تعرّف على كيفية دمج المدفوعات لمرة واحدة وجلسات الدفع وروابط الدفع في تطبيقك
Subscription Integration
دليل كامل لتنفيذ الاشتراكات وإدارة الخطط ومعالجة أحداث دورة حياة الاشتراك
Usage-Based Billing
أعدّ المقاييس وأحداث الاستخدام للفوترة المستندة إلى القياس ونماذج التسعير المستندة إلى الاستهلاك
Webhooks
استلم إشعارات فورية وأتمت سير العمل باستخدام أحداث Webhook
Checkout Sessions
أنشئ تجارب دفع مستضافة وآمنة مع تخصيص كامل وميزات متقدمة