Skip to main content
يوفر SDK بايثون واجهة بايثونية لواجهة برمجة تطبيقات مدفوعات دودو، حيث يقدم عملاء متزامنين وغير متزامنين مع تعريفات نوعية للطلبات والاستجابات. يدعم بايثون 3.9+ ويشمل تغطية شاملة للاختبارات.

التثبيت

قم بتثبيت المكتبة باستخدام pip:
لأداء غير متزامن معزز باستخدام aiohttp:
يتطلب SDK إصدار Python 3.9 أو أحدث. نوصي باستخدام أحدث إصدار ثابت من Python للحصول على أفضل تجربة وتحديثات الأمان.

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

العميل المتزامن

العميل غير المتزامن

قم دائمًا بتخزين مفاتيح API الخاصة بك بأمان باستخدام متغيرات البيئة. لا تقم أبدًا بإضافتها إلى نظام التحكم في الإصدارات.

الميزات الأساسية

Pythonic Interface

كود Python نظيف وبلغة معبرة يتبع إرشادات PEP 8 واتفاقيات Python

Async/Await

دعم كامل للعمليات غير المتزامنة باستخدام asyncio وتكامل aiohttp الاختياري

Type Hints

تلميحات أنواع كاملة لدعم أفضل لبيئة التطوير المتكاملة وفحص الأنواع باستخدام mypy

Auto-Pagination

ترقيم تلقائي لردود القوائم عبر تكرار بسيط

التكوين

متغيرات البيئة

قم بالتكوين باستخدام متغيرات البيئة:
.env

مهلات

قم بتكوين مهلات الطلبات على مستوى عالمي أو لكل طلب:

إعادة المحاولة

قم بتكوين سلوك إعادة المحاولة التلقائي:

العمليات الشائعة

إنشاء جلسة دفع

قم بإنشاء جلسة دفع:

إدارة العملاء

قم بإنشاء واسترجاع معلومات العملاء:

التعامل مع الاشتراكات

قم بإنشاء وإدارة الاشتراكات المتكررة:
POST /subscriptions (the SDK’s subscriptions.create method) مهجور. لا يزال يعمل مع عمليات الدمج الحالية، ولكن يجب أن تنشئ عمليات الدمج الجديدة الاشتراكات من خلال Checkout Session.
يتطلب billing كحد أدنى رمز الدولة المكوّن من حرفين وفق معيار ISO. يقبل customer إما {"customer_id": ...} لربط عميل موجود أو {"email": ..., "name": ...} لإنشاء عميل جديد. تكون قيمة product_price بأدنى فئة من فئات العملة.

الفوترة القائمة على الاستخدام

استيعاب أحداث الاستخدام

تتبّع الأحداث المخصّصة للفوترة القائمة على الاستخدام:

سرد الأحداث واستردادها

الترقيم بالصفحات

الترقيم التلقائي بالصفحات

كرّر العناصر جميعها تلقائيًا:

الترقيم غير المتزامن بالصفحات

الترقيم اليدوي بالصفحات

لمزيد من التحكم في الترقيم بالصفحات:

إعداد عميل HTTP

خصّص عميل httpx الأساسي:

التنفيذ غير المتزامن باستخدام aiohttp

استخدم aiohttp لتحسين الأداء غير المتزامن:

التسجيل

فعّل التسجيل من خلال تعيين متغير البيئة:
أو لتفعيل التسجيل بمستوى التصحيح:

التكامل مع أطر العمل

FastAPI

Django

الموارد

GitHub Repository

عرض التعليمات البرمجية المصدر والمساهمة

API Reference

وثائق API الكاملة

Discord Community

احصل على المساعدة وتواصل مع المطورين

Report Issues

أبلغ عن الأخطاء أو اطلب ميزات

الدعم

هل تحتاج إلى مساعدة بشأن Python SDK؟

المساهمة

نرحّب بالمساهمات! راجع إرشادات المساهمة للبدء.
آخر تعديل في ١٧ أغسطس ٢٠٢٦