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

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

أو مع uv:
4

Get API Credentials

سجل في Dodo Payments واحصل على بيانات الاعتماد من لوحة التحكم:
تأكد من أنك في وضع الاختبار أثناء التطوير!
5

Configure Environment Variables

قم بإنشاء ملف .env في الدليل الجذري:
قم بتحديث القيم باستخدام بيانات اعتماد مدفوعات دودي الخاصة بك:
.env
لا تقم مطلقًا بإضافة ملف .env إلى نظام التحكم في الإصدارات. فهو مدرج بالفعل في .gitignore.
6

Run the Development Server

افتح http://localhost:8000/docs لرؤية وثائق API التفاعلية!
ينبغي أن ترى واجهة Swagger الخاصة بـ FastAPI مع جميع النقاط النهائية المتاحة جاهزة للاختبار.

هيكل المشروع

نقاط نهاية API

يتضمن النموذج نقاط النهاية المُعدة مسبقًا التالية:

أمثلة على الكود

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

معالجة الويب هوك

دمج بوابة العملاء

أحداث الويب هوك

يظهر النموذج كيفية التعامل مع أحداث الويب هوك الشائعة: أضف منطق عملك داخل معالج الويب هوك لـ:
  • تحديث أذونات المستخدم في قاعدة البيانات الخاصة بك
  • إرسال رسائل تأكيد عبر البريد الإلكتروني
  • توفير الوصول إلى المنتجات الرقمية
  • تتبع التحليلات والقياسات

اختبار الويب هوك محليًا

للتطوير المحلي، استخدم أدوات مثل ngrok لفتح خادمك المحلي:
قم بتحديث عنوان URL للويب هوك في لوحة تحكم مدفوعات دودي:

النشر

دوكر

قم بالبناء والتشغيل:

اعتبارات الإنتاج

قبل النشر في الإنتاج:
  • قم بتبديل DODO_PAYMENTS_ENVIRONMENT إلى live_mode
  • استخدم مفاتيح API الخاصة بالإنتاج من لوحة التحكم
  • حدّث عنوان URL الخاص بالـ webhook إلى نطاق الإنتاج
  • فعّل HTTPS لكل النقاط النهائية

استكشاف الأخطاء وإصلاحها

تأكد من تفعيل البيئة الافتراضية وتثبيت التبعيات:
الأسباب الشائعة:
  • معرّف منتج غير صالح - تحقق من وجوده في لوحة Dodo
  • مفتاح API خاطئ أو إعداد بيئة خاطئ في .env
  • تحقق من سجلات FastAPI للحصول على رسائل خطأ مفصلة
للاختبار المحلي، استخدم ngrok لعرض الخادم الخاص بك:
قم بتحديث عنوان URL الخاص بالـ webhook في لوحة Dodo إلى عنوان ngrok. تأكد من تحديث ملف .env بمفتاح التحقق الصحيح للـ webhook.
  • تأكد من تعيين DODO_PAYMENTS_WEBHOOK_KEY بشكل صحيح في ملف .env
  • تحقق من أنك تستخدم جسم الطلب الخام للتحقق من التوقيع
  • تأكد من قراءة رأس webhook-signature بشكل صحيح

تعرف على المزيد

Python SDK

توثيق كامل لـ SDK الخاص بـ Python مع دعم async

Webhooks Documentation

تعرّف على جميع أحداث الـ webhook وأفضل الممارسات

Checkout Sessions

الغوص بعمق في إعداد جلسة الدفع

API Reference

توثيق كامل لواجهة برمجة تطبيقات Dodo Payments

الدعم

تحتاج إلى مساعدة بشأن النموذج؟
آخر تعديل في ٩ يونيو ٢٠٢٦