Skip to main content

GitHub Repository

هيكل متكامل لـ Expo + React Native + Dodo Payments

نظرة عامة

نموذج جاهز للإنتاج لتكامل مدفوعات دودي في تطبيقات إكسبو/React Native. يتضمن هذا القالب إنشاء جلسات الدفع، معالجة المدفوعات، وتكوين TypeScript المناسب لمساعدتك في البدء بقبول المدفوعات في تطبيقك المحمول بسرعة.
يستخدم هذا الهيكل SDK لـ Expo مع TypeScript ويتضمن تنفيذاً نموذجياً لجلسات الدفع ومعالجة المدفوعات.

المتطلبات الأساسية

  • Node.js 18+
  • Expo CLI أو EAS CLI
  • حساب مدفوعات دودي (مفتاح API من لوحة التحكم)
  • محاكي iOS أو محاكي Android (أو جهاز فعلي)

البدء السريع

1

Clone the Repository

استنسخ مستودع الهيكل وانتقل إلى دليل المشروع:
2

Get Your API Credentials

احصل على بيانات الاعتماد من لوحة تحكم Dodo Payments في وضع الاختبار:
ابدأ بوضع الاختبار لاختبار التكامل بأمان دون معالجة مدفوعات حقيقية.
3

Configure Environment Variables

أنشئ ملف .env في الدليل الجذري:
أضف بيانات اعتماد مدفوعات دودي الخاصة بك:
.env
لا تلتزم أبدًا بملف .env بنظام التحكم في الإصدارات. فهو مضمن بالفعل في .gitignore.
يتم تضمين متغيرات EXPO_PUBLIC_* في حزمة JavaScript المشحونة، ويمكن لأي شخص ينزّل تطبيقك قراءتها. مفاتيح Dodo Payments API هي أسرار bearer، لذا استخدم هذا فقط مع مفتاح Test Mode أثناء التطوير. في بيئة الإنتاج، أنشئ جلسات checkout على خادمك الخلفي ومرّر إلى التطبيق فقط checkout_url الناتج — راجع Mobile Integration.
4

Install Dependencies

ثبّت حزم npm المطلوبة:
5

Start the Development Server

شغّل خادم تطوير Expo:
امسح رمز QR باستخدام تطبيق Expo Go على جهازك، أو اضغط i لمحاكي iOS أو a لمحاكي Android.
أنت جاهز لبدء البناء! يتضمن القالب الأساسي شاشات ومكوّنات نموذجية لمساعدتك على فهم عملية التكامل.

ما يتضمنه القالب

يأتي القالب الأساسي مع العناصر الأساسية المُعدّة مسبقًا:

Checkout Integration

تنفيذ نموذجي لإنشاء جلسات checkout ومعالجتها

Payment Handling

تدفق دفع متكامل مع معالجة حالات النجاح والأخطاء

TypeScript Support

إعداد TypeScript كامل مع تعريفات الأنواع المناسبة

Expo Router

إعداد للتنقل باستخدام Expo Router لتوجيه سلس

بنية المشروع

الخطوات التالية

بعد تشغيل القالب الأساسي:
1

Create Your Products

أضف المنتجات في لوحة تحكم Dodo Payments لتمكين وظائف checkout.
2

Customize the Integration

عدّل الشيفرة النموذجية لتتوافق مع احتياجات تطبيقك وتصميمه.
3

Test on Real Devices

اختبر تدفق الدفع على أجهزة فعلية للتأكد من أن كل شيء يعمل بشكل صحيح.
4

Go Live

عندما تصبح جاهزًا، بدّل إلى مفاتيح Live Mode API وأنشئ تطبيقك للإنتاج.

البناء للإنتاج

1

Install EAS CLI

2

Configure EAS

3

Build Your App

لنظام iOS:
لنظام Android:

موارد إضافية

Mobile Integration Guide

دليل تفصيلي لتنفيذ المدفوعات في تطبيقات الأجهزة المحمولة

Integration Guide

دليل تفصيلي لتنفيذ المدفوعات لمرة واحدة

API Reference

استكشف وثائق Dodo Payments API الكاملة

الدعم

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