GitHub Repository
إكمال نموذج FastAPI + Dodo Payments الجاهز
نظرة عامة
يوفر نموذج FastAPI نقطة انطلاق جاهزة للإنتاج لدمج مدفوعات دودي مع بايثون الخلفية الخاصة بك. يتضمن هذا القالب معالجة جلسات الدفع، والتحقق من الويب هوك، ودمج بوابة العملاء، وأنماط API غير المتزامنة لمساعدتك في البدء في قبول المدفوعات بسرعة.يستخدم هذا النموذج FastAPI مع أنماط async/await، وPydantic للتحقق، وواجهة
dodopayments الخاصة بـ Python للتكامل السلس مع واجهة برمجة التطبيقات.الميزات
- إعداد سريع - ابدأ في أقل من 5 دقائق
- دعم غير متزامن - مبني على أنماط async/await الأصلية لـ FastAPI
- جلسات الدفع - تدفق دفع مُعد مسبقًا باستخدام SDK بايثون
- معالجة الويب هوك - نقطة نهاية ويب هوك آمنة مع التحقق من التوقيع
- بوابة العملاء - إنشاء جلسات بوابة العملاء بسهولة
- أمان النوع - تحقق كامل من Pydantic وتلميحات النوع
- تكوين البيئة - إعداد متغيرات البيئة الجاهزة للاستخدام
المتطلبات المسبقة
قبل أن تبدأ، تأكد من أن لديك:- بايثون 3.9+ (موصى به: بايثون 3.11+)
- pip أو uv لإدارة الحزم
- حساب مدفوعات دودي (للوصول إلى مفاتيح API وWebhook من لوحة التحكم)
بدء سريع
1
Clone the Repository
2
Create Virtual Environment
قم بإعداد بيئة Python معزولة:أو باستخدام uv لإدارة التبعيات بشكل أسرع:
3
Install Dependencies
4
Get API Credentials
سجل في Dodo Payments واحصل على بيانات الاعتماد من لوحة التحكم:
- مفتاح API: لوحة التحكم → المطور → مفاتيح API
- مفتاح الويب هوك: لوحة التحكم → المطور → الويب هوك
5
Configure Environment Variables
قم بإنشاء ملف قم بتحديث القيم باستخدام بيانات اعتماد مدفوعات دودي الخاصة بك:
.env في الدليل الجذري:.env
6
Run the Development Server
ينبغي أن ترى واجهة Swagger الخاصة بـ FastAPI مع جميع النقاط النهائية المتاحة جاهزة للاختبار.
هيكل المشروع
نقاط نهاية API
يتضمن النموذج نقاط النهاية المُعدة مسبقًا التالية:أمثلة على الكود
إنشاء جلسة دفع
معالجة الويب هوك
دمج بوابة العملاء
أحداث الويب هوك
يظهر النموذج كيفية التعامل مع أحداث الويب هوك الشائعة:
أضف منطق عملك داخل معالج الويب هوك لـ:
- تحديث أذونات المستخدم في قاعدة البيانات الخاصة بك
- إرسال رسائل تأكيد عبر البريد الإلكتروني
- توفير الوصول إلى المنتجات الرقمية
- تتبع التحليلات والقياسات
اختبار الويب هوك محليًا
للتطوير المحلي، استخدم أدوات مثل ngrok لفتح خادمك المحلي:النشر
دوكر
اعتبارات الإنتاج
استكشاف الأخطاء وإصلاحها
Import errors or missing modules
Import errors or missing modules
تأكد من تفعيل البيئة الافتراضية وتثبيت التبعيات:
Checkout session creation fails
Checkout session creation fails
الأسباب الشائعة:
- معرّف منتج غير صالح - تحقق من وجوده في لوحة Dodo
- مفتاح API خاطئ أو إعداد بيئة خاطئ في
.env - تحقق من سجلات FastAPI للحصول على رسائل خطأ مفصلة
Webhooks not receiving events
Webhooks not receiving events
Webhook signature verification fails
Webhook signature verification fails
- تأكد من تعيين
DODO_PAYMENTS_WEBHOOK_KEYبشكل صحيح في ملف.env - تحقق من أنك تستخدم جسم الطلب الخام للتحقق من التوقيع
- تأكد من قراءة رأس
webhook-signatureبشكل صحيح
تعرف على المزيد
Python SDK
توثيق كامل لـ SDK الخاص بـ Python مع دعم async
Webhooks Documentation
تعرّف على جميع أحداث الـ webhook وأفضل الممارسات
Checkout Sessions
الغوص بعمق في إعداد جلسة الدفع
API Reference
توثيق كامل لواجهة برمجة تطبيقات Dodo Payments
الدعم
تحتاج إلى مساعدة بشأن النموذج؟- انضم إلى مجتمع Discord لطرح الأسئلة والمناقشات
- تحقق من مستودع GitHub للمشكلات والتحديثات
- اتصل بفريق الدعم لدينا للحصول على المساعدة